chore: emit LS markdown sources

Author: cdotlock

README.md

@@ -14,17 +14,17 @@ go build -o bin/lscc ./cmd/lscc
 
 ```bash
 # Compile a single episode
-lsc compile episode.ls --assets mapping.json -o output.json
+lsc compile episode.ls.md --assets mapping.json -o output.json
 
 # Compile an entire novel directory
 lsc compile novel_001/main/ --assets mapping.json -o novel.json
 
 # Decompile compiled JSON back to LS + recovered asset mapping
 lsc decompile output.json
-# writes output_decompiled/episode.ls and output_decompiled/assets_mapping.json
+# writes output_decompiled/episode.ls.md and output_decompiled/assets_mapping.json
 
 # Validate syntax only
-lsc validate episode.ls
+lsc validate episode.ls.md
 ```
 
 ## Script Format

api_server.py

@@ -34,11 +34,11 @@ def _run_ls(*args: str, workdir: Optional[str] = None, timeout: int = 30) -> sub
 
 @app.post("/compile")
 async def compile_script(
-    script: UploadFile = File(..., description="LS script file (.ls)"),
+    script: UploadFile = File(..., description="LS script file (.ls or .ls.md)"),
     assets: Optional[UploadFile] = File(default=None, description="Optional assets mapping JSON file"),
 ):
     """
-    Compile a single LS script (.ls) into structured JSON.
+    Compile a single LS script (.ls or .ls.md) into structured JSON.
 
     Returns the compiled episode JSON. If an assets mapping is provided,
     asset semantic names are resolved to full URLs.
@@ -47,7 +47,7 @@ async def compile_script(
     try:
         script_bytes = await script.read()
         script_text = script_bytes.decode("utf-8")
-        script_path = os.path.join(tmpdir, "script.ls")
+        script_path = os.path.join(tmpdir, "script.ls.md")
         with open(script_path, "w", encoding="utf-8") as f:
             f.write(script_text)
 
@@ -93,8 +93,8 @@ async def compile_directory(
     """
     Compile an entire episode directory (uploaded as a zip) into structured JSON.
 
-    The zip should contain one or more `.ls` files (e.g. 01.ls, 02.ls, …).
-    Directory structure inside the zip is flattened — all `.ls` / `.episode.ls` files are
+    The zip should contain one or more `.ls` / `.ls.md` files (e.g. 01.ls.md, 02.ls.md, …).
+    Directory structure inside the zip is flattened — all `.ls` / `.ls.md` / `.episode.ls` / `.episode.ls.md` files are
     discovered recursively and compiled together.
 
     Returns the compiled novel JSON (keyed by episode_id).
@@ -152,7 +152,7 @@ async def decompile_json(
     """
     Decompile compiled LS JSON back into LS script and asset mapping.
 
-    Returns the reconstructed LS source (.ls) and the recovered asset mapping.
+    Returns the reconstructed LS source (.ls.md) and the recovered asset mapping.
     """
     tmpdir = tempfile.mkdtemp(prefix="ls_decompile_")
     try:
@@ -187,7 +187,12 @@ async def decompile_json(
         mapping = None
         for fname in os.listdir(output_dir):
             fpath = os.path.join(output_dir, fname)
-            if fname.endswith(".ls") or fname.endswith(".episode.ls"):
+            if (
+                fname.endswith(".ls")
+                or fname.endswith(".ls.md")
+                or fname.endswith(".episode.ls")
+                or fname.endswith(".episode.ls.md")
+            ):
                 with open(fpath, "r", encoding="utf-8") as f:
                     ls_files[fname] = f.read()
             elif fname.endswith(".json"):
@@ -216,7 +221,7 @@ async def decompile_json(
 
 @app.post("/validate")
 async def validate_script(
-    script: UploadFile = File(..., description="LS script file (.ls) to validate"),
+    script: UploadFile = File(..., description="LS script file (.ls or .ls.md) to validate"),
     assets: Optional[UploadFile] = File(default=None, description="Optional assets mapping JSON file"),
 ):
     """
@@ -228,7 +233,7 @@ async def validate_script(
     try:
         script_bytes = await script.read()
         script_text = script_bytes.decode("utf-8")
-        script_path = os.path.join(tmpdir, "script.ls")
+        script_path = os.path.join(tmpdir, "script.ls.md")
         with open(script_path, "w", encoding="utf-8") as f:
             f.write(script_text)
 
@@ -267,7 +272,7 @@ async def validate_script(
 
 @app.post("/fix")
 async def fix_script(
-    script: UploadFile = File(..., description="LS script file (.ls) to fix"),
+    script: UploadFile = File(..., description="LS script file (.ls or .ls.md) to fix"),
     check: bool = Query(default=False, description="Dry-run: report issues without writing changes"),
 ):
     """
@@ -283,7 +288,7 @@ async def fix_script(
     try:
         script_bytes = await script.read()
         script_text = script_bytes.decode("utf-8")
-        script_path = os.path.join(tmpdir, "script.ls")
+        script_path = os.path.join(tmpdir, "script.ls.md")
         with open(script_path, "w", encoding="utf-8") as f:
             f.write(script_text)
 
@@ -297,7 +302,7 @@ async def fix_script(
                 }
             )
         else:
-            output_path = os.path.join(tmpdir, "fixed.ls")
+            output_path = os.path.join(tmpdir, "fixed.ls.md")
             proc = _run_ls("fix", script_path, "-o", output_path, timeout=30)
 
             if proc.returncode != 0 and not os.path.exists(output_path):

cmd/lsc/main.go

@@ -39,11 +39,11 @@ func usage() {
 	fmt.Fprintln(os.Stderr, "lsc - Lunascripts interpreter")
 	fmt.Fprintln(os.Stderr, "")
 	fmt.Fprintln(os.Stderr, "Usage:")
-	fmt.Fprintln(os.Stderr, "  lsc compile <file.ls|dir/> [--assets mapping.json] [-o output.json]")
-	fmt.Fprintln(os.Stderr, "  lsc decompile <output.json> [-o output-dir]  Rebuild .ls + assets_mapping.json")
-	fmt.Fprintln(os.Stderr, "  lsc validate <file.ls> [--assets mapping.json]")
-	fmt.Fprintln(os.Stderr, "  lsc fix <file.ls> [-o output.ls]     Fix and write (in-place if no -o)")
-	fmt.Fprintln(os.Stderr, "  lsc fix <file.ls> --check            Dry run: report issues, don't write")
+	fmt.Fprintln(os.Stderr, "  lsc compile <file.ls|file.ls.md|dir/> [--assets mapping.json] [-o output.json]")
+	fmt.Fprintln(os.Stderr, "  lsc decompile <output.json> [-o output-dir]  Rebuild .ls.md + assets_mapping.json")
+	fmt.Fprintln(os.Stderr, "  lsc validate <file.ls|file.ls.md> [--assets mapping.json]")
+	fmt.Fprintln(os.Stderr, "  lsc fix <file.ls|file.ls.md> [-o output.ls.md]     Fix and write (in-place if no -o)")
+	fmt.Fprintln(os.Stderr, "  lsc fix <file.ls|file.ls.md> --check            Dry run: report issues, don't write")
 	os.Exit(1)
 }
 
@@ -159,7 +159,7 @@ func cmdDecompile(args []string) {
 	for _, ep := range result.Episodes {
 		name := ep.Name
 		if len(result.Episodes) == 1 {
-			name = "episode.ls"
+			name = "episode.ls.md"
 		}
 		path := filepath.Join(outputDir, name)
 		if err := os.WriteFile(path, ep.Source, 0644); err != nil {
@@ -231,7 +231,7 @@ func compileFile(path string, res emitter.AssetResolver) ([]byte, error) {
 }
 
 func isLsSourcePath(path string) bool {
-	return strings.HasSuffix(path, ".ls") || strings.HasSuffix(path, ".ls.md")
+	return strings.HasSuffix(path, ".ls.md") || strings.HasSuffix(path, ".ls")
 }
 
 func compileDir(dir string, res emitter.AssetResolver) ([]byte, error) {

internal/decompiler/decompiler.go

@@ -129,15 +129,15 @@ func episodeFileName(ep map[string]interface{}, idx int) string {
 	if id == "" {
 		id = fmt.Sprintf("episode_%02d", idx+1)
 	}
-	return sanitizeFileName(id) + ".ls"
+	return sanitizeFileName(id) + ".ls.md"
 }
 
 func uniqueEpisodeFileName(name string, used map[string]int) string {
 	used[name]++
 	if used[name] == 1 {
 		return name
 	}
-	return strings.TrimSuffix(name, ".ls") + fmt.Sprintf("_%d.ls", used[name])
+	return strings.TrimSuffix(name, ".ls.md") + fmt.Sprintf("_%d.ls.md", used[name])
 }
 
 func sanitizeFileName(s string) string {