stego-cli 0.1.7 → 0.2.0

package/README.md

@@ -19,6 +19,7 @@ npm install
 stego list-projects
 stego validate --project fiction-example
 stego build --project fiction-example
+stego new --project fiction-example
 ```
 
 `stego init` scaffolds two example projects:
@@ -26,7 +27,7 @@ stego build --project fiction-example
 - `stego-docs` (the full documentation project)
 - `fiction-example` (a fiction-oriented demo with rich Spine usage)
 
-For day-to-day editing, open a project folder in VS Code (for example `projects/stego-docs`) and use the Stego VS Code extension, which is the official UI for Stego projects.
+For day-to-day editing, open a project folder in VS Code (for example `projects/stego-docs`) and use the [Stego VS Code extension](https://github.com/matt-gold/stego-extension), which is the official UI for Stego projects.
 
 ## Full documentation
 
@@ -48,6 +49,7 @@ Run commands from the workspace root and target a project with `--project`.
 ```bash
 stego list-projects
 stego new-project --project my-book --title "My Book"
+stego new --project fiction-example
 stego validate --project fiction-example
 stego build --project fiction-example
 stego check-stage --project fiction-example --stage revise

package/dist/stego-cli.js

@@ -16,6 +16,7 @@ const STATUS_RANK = {
     final: 4
 };
 const RESERVED_COMMENT_PREFIX = "CMT";
+const DEFAULT_NEW_MANUSCRIPT_SLUG = "new-document";
 const ROOT_CONFIG_FILENAME = "stego.config.json";
 const PROSE_FONT_PROMPT = "Switch workspace to proportional (prose-style) font? (recommended)";
 const SCAFFOLD_GITIGNORE_CONTENT = `node_modules/
@@ -54,6 +55,7 @@ stego validate --project fiction-example
 stego build --project fiction-example
 stego check-stage --project fiction-example --stage revise
 stego export --project fiction-example --format md
+stego new --project fiction-example
 \`\`\`
 
 ## Work inside one project
@@ -77,6 +79,12 @@ This keeps your editor context focused and applies the project's recommended ext
 \`\`\`bash
 stego new-project --project my-book --title "My Book"
 \`\`\`
+
+## Add a new manuscript file
+
+\`\`\`bash
+stego new --project fiction-example
+\`\`\`
 `;
 const PROSE_MARKDOWN_EDITOR_SETTINGS = {
     "[markdown]": {
@@ -117,6 +125,13 @@ async function main() {
                 activateWorkspace(options);
                 await createProject(readStringOption(options, "project"), readStringOption(options, "title"));
                 return;
+            case "new": {
+                activateWorkspace(options);
+                const project = resolveProject(readStringOption(options, "project"));
+                const createdPath = createNewManuscript(project, readStringOption(options, "i"));
+                logLine(`Created manuscript: ${createdPath}`);
+                return;
+            }
             case "validate": {
                 activateWorkspace(options);
                 const project = resolveProject(readStringOption(options, "project"));
@@ -394,18 +409,36 @@ function parseArgs(argv) {
     const options = { _: [] };
     for (let i = 0; i < rest.length; i += 1) {
         const token = rest[i];
-        if (!token.startsWith("--")) {
-            options._.push(token);
+        if (token === "--") {
+            options._.push(...rest.slice(i + 1));
+            break;
+        }
+        if (token.startsWith("--")) {
+            const key = token.slice(2);
+            const next = rest[i + 1];
+            if (!next || next.startsWith("-")) {
+                options[key] = true;
+                continue;
+            }
+            options[key] = next;
+            i += 1;
             continue;
         }
-        const key = token.slice(2);
-        const next = rest[i + 1];
-        if (!next || next.startsWith("--")) {
-            options[key] = true;
+        if (token.startsWith("-") && token.length > 1) {
+            const key = token.slice(1);
+            const next = rest[i + 1];
+            if (!next || next.startsWith("-")) {
+                options[key] = true;
+                continue;
+            }
+            options[key] = next;
+            i += 1;
+            continue;
+        }
+        if (!token.startsWith("--")) {
+            options._.push(token);
             continue;
         }
-        options[key] = next;
-        i += 1;
     }
     return { command, options };
 }
@@ -607,6 +640,7 @@ function rewriteTemplateProjectPackageScripts(targetRoot) {
         scripts.build = "npx --no-install stego build";
         scripts["check-stage"] = "npx --no-install stego check-stage";
         scripts.export = "npx --no-install stego export";
+        scripts.new = "npx --no-install stego new";
         projectPackage.scripts = scripts;
         fs.writeFileSync(packageJsonPath, `${JSON.stringify(projectPackage, null, 2)}\n`, "utf8");
         ensureProjectExtensionsRecommendations(projectRoot);
@@ -697,6 +731,7 @@ function writeInitRootPackageJson(targetRoot) {
         scripts: {
             "list-projects": "stego list-projects",
             "new-project": "stego new-project",
+            new: "stego new",
             lint: "stego lint",
             validate: "stego validate",
             build: "stego build",
@@ -712,7 +747,7 @@ function writeInitRootPackageJson(targetRoot) {
     fs.writeFileSync(path.join(targetRoot, "package.json"), `${JSON.stringify(manifest, null, 2)}\n`, "utf8");
 }
 function printUsage() {
-    console.log(`Stego CLI\n\nCommands:\n  init [--force]\n  list-projects [--root <path>]\n  new-project --project <project-id> [--title <title>] [--root <path>]\n  validate --project <project-id> [--file <project-relative-manuscript-path>] [--root <path>]\n  build --project <project-id> [--root <path>]\n  check-stage --project <project-id> --stage <draft|revise|line-edit|proof|final> [--file <project-relative-manuscript-path>] [--root <path>]\n  lint --project <project-id> [--manuscript|--spine] [--root <path>]\n  export --project <project-id> --format <md|docx|pdf|epub> [--output <path>] [--root <path>]\n`);
+    console.log(`Stego CLI\n\nCommands:\n  init [--force]\n  list-projects [--root <path>]\n  new-project --project <project-id> [--title <title>] [--root <path>]\n  new --project <project-id> [--i <prefix>|-i <prefix>] [--root <path>]\n  validate --project <project-id> [--file <project-relative-manuscript-path>] [--root <path>]\n  build --project <project-id> [--root <path>]\n  check-stage --project <project-id> --stage <draft|revise|line-edit|proof|final> [--file <project-relative-manuscript-path>] [--root <path>]\n  lint --project <project-id> [--manuscript|--spine] [--root <path>]\n  export --project <project-id> --format <md|docx|pdf|epub> [--output <path>] [--root <path>]\n`);
 }
 function listProjects() {
     const ids = getProjectIds();
@@ -774,6 +809,7 @@ async function createProject(projectIdOption, titleOption) {
         name: `stego-project-${projectId}`,
         private: true,
         scripts: {
+            new: "npx --no-install stego new",
             lint: "npx --no-install stego lint",
             validate: "npx --no-install stego validate",
             build: "npx --no-install stego build",
@@ -813,6 +849,96 @@ Start writing here.
         logLine(`- ${path.relative(repoRoot, projectSettingsPath)}`);
     }
 }
+function createNewManuscript(project, requestedPrefixRaw) {
+    fs.mkdirSync(project.manuscriptDir, { recursive: true });
+    const requiredMetadataState = resolveRequiredMetadata(project, config);
+    const requiredMetadataErrors = requiredMetadataState.issues
+        .filter((issue) => issue.level === "error")
+        .map((issue) => issue.message);
+    if (requiredMetadataErrors.length > 0) {
+        throw new Error(`Unable to resolve required metadata for project '${project.id}': ${requiredMetadataErrors.join(" ")}`);
+    }
+    const existingEntries = listManuscriptOrderEntries(project.manuscriptDir);
+    const explicitPrefix = parseManuscriptPrefix(requestedPrefixRaw);
+    const nextPrefix = explicitPrefix ?? inferNextManuscriptPrefix(existingEntries);
+    const collision = existingEntries.find((entry) => entry.order === nextPrefix);
+    if (collision) {
+        throw new Error(`Manuscript prefix '${nextPrefix}' is already used by '${collision.filename}'. Re-run with --i <number> to choose an unused prefix.`);
+    }
+    const filename = `${nextPrefix}-${DEFAULT_NEW_MANUSCRIPT_SLUG}.md`;
+    const manuscriptPath = path.join(project.manuscriptDir, filename);
+    const content = renderNewManuscriptTemplate(requiredMetadataState.requiredMetadata);
+    fs.writeFileSync(manuscriptPath, content, "utf8");
+    return path.relative(repoRoot, manuscriptPath);
+}
+function listManuscriptOrderEntries(manuscriptDir) {
+    if (!fs.existsSync(manuscriptDir)) {
+        return [];
+    }
+    return fs
+        .readdirSync(manuscriptDir, { withFileTypes: true })
+        .filter((entry) => entry.isFile() && entry.name.endsWith(".md"))
+        .map((entry) => {
+        const match = entry.name.match(/^(\d+)[-_]/);
+        if (!match) {
+            return null;
+        }
+        return {
+            order: Number(match[1]),
+            filename: entry.name
+        };
+    })
+        .filter((entry) => entry !== null)
+        .sort((a, b) => {
+        if (a.order === b.order) {
+            return a.filename.localeCompare(b.filename);
+        }
+        return a.order - b.order;
+    });
+}
+function parseManuscriptPrefix(raw) {
+    if (raw == null) {
+        return undefined;
+    }
+    const normalized = raw.trim();
+    if (!normalized) {
+        throw new Error("Option --i/-i requires a numeric value.");
+    }
+    if (!/^\d+$/.test(normalized)) {
+        throw new Error(`Invalid manuscript prefix '${raw}'. Use a non-negative integer.`);
+    }
+    const parsed = Number(normalized);
+    if (!Number.isSafeInteger(parsed)) {
+        throw new Error(`Invalid manuscript prefix '${raw}'. Use a smaller integer value.`);
+    }
+    return parsed;
+}
+function inferNextManuscriptPrefix(entries) {
+    if (entries.length === 0) {
+        return 100;
+    }
+    if (entries.length === 1) {
+        return entries[0].order + 100;
+    }
+    const previous = entries[entries.length - 2].order;
+    const latest = entries[entries.length - 1].order;
+    const step = latest - previous;
+    return latest + (step > 0 ? step : 1);
+}
+function renderNewManuscriptTemplate(requiredMetadata) {
+    const lines = ["---", "status: draft"];
+    const seenKeys = new Set(["status"]);
+    for (const key of requiredMetadata) {
+        const normalized = key.trim();
+        if (!normalized || seenKeys.has(normalized)) {
+            continue;
+        }
+        seenKeys.add(normalized);
+        lines.push(`${normalized}:`);
+    }
+    lines.push("---", "", "# New Document", "");
+    return `${lines.join("\n")}\n`;
+}
 function getProjectIds() {
     const projectsDir = path.join(repoRoot, config.projectsDir);
     if (!fs.existsSync(projectsDir)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stego-cli",
-  "version": "0.1.7",
+  "version": "0.2.0",
   "type": "module",
   "description": "Installable CLI for the Stego writing monorepo workflow.",
   "license": "Apache-2.0",
@@ -42,6 +42,7 @@
     "release:version": "changeset version",
     "list-projects": "node --experimental-strip-types tools/stego-cli.ts list-projects",
     "new-project": "node --experimental-strip-types tools/stego-cli.ts new-project",
+    "new": "node --experimental-strip-types tools/stego-cli.ts new",
     "lint": "node --experimental-strip-types tools/stego-cli.ts lint",
     "validate": "node --experimental-strip-types tools/stego-cli.ts validate",
     "build": "node --experimental-strip-types tools/stego-cli.ts build",

package/projects/fiction-example/package.json

@@ -2,6 +2,7 @@
   "name": "stego-project-fiction-example",
   "private": true,
   "scripts": {
+    "new": "node --experimental-strip-types ../../tools/stego-cli.ts new",
     "validate": "node --experimental-strip-types ../../tools/stego-cli.ts validate",
     "build": "node --experimental-strip-types ../../tools/stego-cli.ts build",
     "check-stage": "node --experimental-strip-types ../../tools/stego-cli.ts check-stage",

package/projects/stego-docs/manuscript/400-everyday-workflow-and-commands.md

@@ -10,6 +10,7 @@ concepts:
 commands:
   - CMD-LIST-PROJECTS
   - CMD-NEW-PROJECT
+  - CMD-NEW
   - CMD-VALIDATE
   - CMD-BUILD
   - CMD-CHECK-STAGE
@@ -41,6 +42,7 @@ From the workspace root, target a project with `--project`.
 
 ```bash
 stego list-projects
+stego new --project fiction-example
 stego validate --project fiction-example
 stego build --project fiction-example
 stego check-stage --project fiction-example --stage revise
@@ -53,6 +55,7 @@ Projects also include local npm scripts. These are useful when you want to stay
 
 ```bash
 cd projects/fiction-example
+npm run new
 npm run validate
 npm run build
 npm run check-stage -- --stage revise

package/projects/stego-docs/package.json

@@ -2,6 +2,7 @@
   "name": "stego-project-stego-docs",
   "private": true,
   "scripts": {
+    "new": "node --experimental-strip-types ../../tools/stego-cli.ts new",
     "validate": "node --experimental-strip-types ../../tools/stego-cli.ts validate",
     "build": "node --experimental-strip-types ../../tools/stego-cli.ts build",
     "check-stage": "node --experimental-strip-types ../../tools/stego-cli.ts check-stage",

package/projects/stego-docs/spine/commands.md

@@ -25,6 +25,15 @@ label: stego new-project --project <project-id> [--title <title>] [--root <path>
 - Related workflows: FLOW-NEW-PROJECT.
 - Related concepts: CON-PROJECT, CON-MANUSCRIPT, CON-NOTES, CON-DIST.
 
+## CMD-NEW
+label: stego new --project <project-id> [--i <prefix>|-i <prefix>] [--root <path>]
+
+- `stego new --project <project-id> [--i <prefix>|-i <prefix>] [--root <path>]`
+- Create a new manuscript file with an inferred numeric prefix and draft frontmatter.
+- Related workflows: FLOW-DAILY-WRITING.
+- Related concepts: CON-MANUSCRIPT, CON-METADATA.
+- Related configuration: CFG-REQUIRED-METADATA.
+
 ## CMD-VALIDATE
 label: stego validate --project <project-id> [--file <project-relative-manuscript-path>] [--root <path>]