document360-writer 0.5.36 → 0.5.38

package/dist/commands/write.d.ts

@@ -10,13 +10,15 @@ export declare const MAX_WRITE_CONCURRENCY = 8;
 export declare function resolveConcurrency(requested?: number): number;
 /** Parse /write args. The default ACTION is to write — `/write` starts immediately. `--preview` asks
     for the plan + cost estimate only (no spend). `--scope <cat>` (or `--scope=…`) narrows, `--concurrency
-    <n>` tunes parallelism, a bare `<path>` writes one article. `--run`/`--all`/`--yes` are accepted as
-    legacy no-ops (writing is the default now) so old quick-options / muscle memory don't error. */
+    <n>` tunes parallelism, a bare `<path>` writes one article. `--rewrite` (alias `--force`) regenerates
+    ALREADY-written articles in scope too (the normal scope/all run skips written ones) — the iterate loop
+    after a plan/playbook change. `--run`/`--all`/`--yes` are accepted as legacy no-ops. */
 export declare function parseWriteArgs(args: string[]): {
     scope?: string;
     path?: string;
     preview: boolean;
     concurrency?: number;
+    rewrite: boolean;
 };
 /** Drop a leading `<docsDir>/` so a path given repo-relative matches the docsDir-relative plan keys. */
 export declare function toPlanRelative(p: string, docsDir: string): string;
@@ -28,8 +30,13 @@ export declare function pendingArticles(cwd: string, docsDir: string, paths: str
     1-byte floor keeps every planned article in the estimate so its per-article overhead counts. */
 export declare function sizeWriteTargets(cwd: string, entries: DocsPlanEntry[], paths: string[]): TargetFile[];
 /** The agent prompt for one partition: author each listed article from the plan. Each is
-    independent; purpose + sources are looked up from the pinned plan, grounded in source. */
-export declare function buildWritePrompt(partition: Partition, docsDir: string): string;
+    independent; purpose + sources are looked up from the pinned plan, grounded in source.
+    `rewrite` ⇒ the targets already exist (a `--rewrite`/single-path re-author): tell the agent to rebuild
+    from plan + sources + the active doc-type playbook, NOT to preserve or lightly-edit the old file — else
+    it anchors on the prior (possibly junior) output and reproduces it (dogfood P-A A5). */
+export declare function buildWritePrompt(partition: Partition, docsDir: string, opts?: {
+    rewrite?: boolean;
+}): string;
 /** Preview lines for `/write --preview`: the partition plan + the cost band, before any spend. */
 export declare function previewLines(partitions: Partition[], estimate: CostEstimate, concurrency: number): string[];
 /**
@@ -45,11 +52,13 @@ export declare function summaryLines(results: PartitionResult[], partitions: Par
 export declare function selectWriteTargets(cwd: string, entries: DocsPlanEntry[], args: {
     scope?: string;
     path?: string;
+    rewrite?: boolean;
 }): {
     docsDir: string;
     targets: string[];
     planCount: number;
     reason?: string;
+    rewriting?: boolean;
 };
 /**
  * Classic-REPL `/write` — parity with the TUI handler (App.tsx): `/write [--scope x]` writes the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "document360-writer",
-  "version": "0.5.36",
+  "version": "0.5.38",
   "description": "Standalone documentation agent CLI. Reads your code, writes your docs. Specialized for Document360 publishing.",
   "type": "module",
   "bin": {
@@ -34,7 +34,7 @@
     "@inquirer/prompts": "^8.4.3",
     "commander": "^14.0.3",
     "diff": "^8.0.4",
-    "document360-engine": "^0.2.75",
+    "document360-engine": "^0.2.76",
     "ink": "^5.2.1",
     "picocolors": "^1.1.1",
     "react": "^18.3.1",