document360-writer 0.5.10 → 0.5.12

package/dist/commands/write.d.ts

@@ -1,13 +1,22 @@
 import { type CostEstimate, type DocsPlanEntry, type Partition, type PartitionResult, type TargetFile } from 'document360-engine';
 import type { ReplContext } from '../repl.js';
 import type { SlashCommandResult } from './index.js';
-/** Partitions running at once — local-only work (no D360 rate limit), so higher than /convert. */
-export declare const WRITE_CONCURRENCY = 5;
-/** Parse /write args: `--run`/`--yes`, `--scope <cat>` (or `--scope=…`), `--all`, or a bare `<path>`. */
+/** Partitions running at once. Each is a heavy Claude Code subprocess; on a dev laptop 5 at once
+    starved memory and aborted a worker hard (SNAG-0223 → SNAG-0222 cascade), so the default is a
+    safer 3. Override per-run with `--concurrency N` (capped at MAX_WRITE_CONCURRENCY). */
+export declare const WRITE_CONCURRENCY = 3;
+export declare const MAX_WRITE_CONCURRENCY = 8;
+/** Clamp a requested concurrency to [1, MAX]; non-numeric/absent → the default. */
+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. */
 export declare function parseWriteArgs(args: string[]): {
     scope?: string;
     path?: string;
-    run: boolean;
+    preview: boolean;
+    concurrency?: number;
 };
 /** 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;
@@ -21,7 +30,7 @@ export declare function sizeWriteTargets(cwd: string, entries: DocsPlanEntry[],
 /** 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;
-/** Preview lines for bare `/write`: the partition plan + the cost band, before any spend. */
+/** 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[];
 /**
  * Final summary, a bookend to the opening "Writing N articles across M partitions…" line. Usage
@@ -43,9 +52,9 @@ export declare function selectWriteTargets(cwd: string, entries: DocsPlanEntry[]
     reason?: string;
 };
 /**
- * Classic-REPL `/write` — parity with the TUI handler (App.tsx): bare `/write [--scope x]` previews
- * (plan + cost band, no spend); `/write --run` fans the planned articles out across parallel agents.
- * A single `<path>` writes that article immediately. Mid-run abort is TUI-only (Esc); Ctrl+C exits
- * the REPL here.
+ * Classic-REPL `/write` — parity with the TUI handler (App.tsx): `/write [--scope x]` writes the
+ * planned articles across parallel agents immediately; `/write --preview` shows the plan + cost first
+ * (no spend). A single `<path>` writes that article immediately. Mid-run abort is TUI-only (Esc);
+ * Ctrl+C exits the REPL here.
  */
 export declare function writeCommand(args: string[], ctx: ReplContext): Promise<SlashCommandResult>;

package/dist/lib/crashHandler.d.ts

@@ -0,0 +1,2 @@
+/** Install once at startup. `label` names the running command in the log (e.g. 'd360-writer'). */
+export declare function installCrashHandlers(label: string): void;

package/dist/lib/nextActions.d.ts

@@ -8,6 +8,10 @@ export type ReadyInputs = {
     tracked: number;
     /** `pendingLine(pendingSummary())` — e.g. "2 hints, 1 request", or null when nothing's queued. */
     pendingText: string | null;
+    /** Planned articles (plan.json) not yet written — missing/empty files. >0 after an interrupted /write
+        (e.g. a crash mid-run) or a freshly-pinned plan with bodies still to generate. Drives the "pick up
+        where you left off" → /write lead so a half-done generation isn't buried under /audit + /sync. */
+    pendingWrites: number;
     /** Commits on HEAD since the last `/audit` marker (0 when never audited or not a git repo). */
     behind: number;
     /** The user's `/audit --auto on` setting. */

package/dist/tui/HelpModal.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+/** Interactive /help — a Claude-Code-style tabbed modal. Tab/←/→ (or 1-5) switch sections, esc closes.
+    Key routing + the `helpModal` state live in App.tsx (mirrors the other pickers). */
+export declare function HelpModal({ tab, width }: {
+    tab: number;
+    width: number;
+}): React.ReactElement;

package/dist/tui/catalog.d.ts

@@ -6,12 +6,9 @@ export type CommandSpec = {
     group: CommandGroup;
 };
 export declare const COMMANDS: CommandSpec[];
-/** The /help text — ONE source of truth for the TUI and the classic REPL. Organized by the two ways
-    people actually use d360-writer (keep-docs-in-sync vs. write-specific-docs) rather than by command
-    type, so a reader finds the handful of commands their situation needs instead of scanning a flat
-    list. Plain strings (no ANSI) so the TUI can push it as a note without leaking escape codes.
-    (The `/` palette still lists every command via COMMANDS/filterCommands — this is the teaching surface.) */
-export declare function renderGroupedHelp(): string[];
+/** A one-line description for a quick-list option (full command line, e.g. "/publish --all"). Curated
+    map first, then the catalog `desc` by base command, else ''. */
+export declare function describeQuickOption(cmdLine: string): string;
 /** Commands whose body filters as you type `/<prefix>`. */
 export declare function filterCommands(input: string): CommandSpec[];
 /** True when the usage has a REQUIRED argument (`<...>` outside optional `[...]`

package/dist/tui/helpContent.d.ts

@@ -0,0 +1,35 @@
+export type HelpRow = {
+    t: 'head';
+    s: string;
+} | {
+    t: 'text';
+    s: string;
+} | {
+    t: 'dim';
+    s: string;
+} | {
+    t: 'sub';
+    s: string;
+} | {
+    t: 'good';
+    s: string;
+} | {
+    t: 'step';
+    n: number;
+    s: string;
+} | {
+    t: 'cmd';
+    name: string;
+    s: string;
+} | {
+    t: 'gap';
+};
+export type HelpTab = {
+    key: string;
+    label: string;
+    rows: HelpRow[];
+};
+export declare const HELP_TABS: HelpTab[];
+/** Flatten every tab to plain strings — the classic REPL has no modal, so it prints the
+    sections linearly under their headers. */
+export declare function renderHelpPlain(): string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "document360-writer",
-  "version": "0.5.10",
+  "version": "0.5.12",
   "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.59",
+    "document360-engine": "^0.2.61",
     "ink": "^5.2.1",
     "picocolors": "^1.1.1",
     "react": "^18.3.1",