document360-writer 0.5.8 → 0.5.10

package/dist/lib/nextActions.d.ts

@@ -0,0 +1,51 @@
+/** Inputs the decision needs, all already read from disk by the caller. */
+export type ReadyInputs = {
+    /** Configured + signed in + scope ok + Claude present. False ⇒ the setup ladder owns the screen. */
+    ready: boolean;
+    /** Any tracked docs exist locally (a non-empty docsDir). */
+    hasDocs: boolean;
+    /** Count of articles in the category map for the active profile. */
+    tracked: number;
+    /** `pendingLine(pendingSummary())` — e.g. "2 hints, 1 request", or null when nothing's queued. */
+    pendingText: string | null;
+    /** 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. */
+    autoAudit: boolean;
+    /** Active profile/connection name, for the "N articles tracked for X" line. */
+    profileName: string;
+    /** Whether the caller may auto-run /audit (true only at launch — never on the post-turn refresh,
+        which would loop). When false, a would-be auto-audit degrades to offering /audit in the list. */
+    allowAutoAudit: boolean;
+};
+export type ReadyDecision = 
+/** Not in the ready state — the caller must leave the quick-list/ghost untouched (setup ladder owns it). */
+{
+    kind: 'idle';
+}
+/** Launch only: code moved + auto-audit on ⇒ run /audit now. `note` is the ambient line to show. */
+ | {
+    kind: 'autoAudit';
+    note: string;
+}
+/** No docs yet: cold-start. `note` is the transcript line, `ghost` the tab-fill, `options`/`title` the list. */
+ | {
+    kind: 'noDocs';
+    note: string;
+    ghost: string;
+    title: string | null;
+    options: string[];
+}
+/** Docs exist: the steady-state next-actions. `note` is the launch transcript block; `title`+`options`
+    are the durable quick-list (also restored after every turn). */
+ | {
+    kind: 'actions';
+    note: string;
+    title: string;
+    options: string[];
+};
+/**
+ * Decide the next actions from already-gathered inputs. Pure — no I/O — so it's unit-tested and is the
+ * one place option order + copy is defined. Mirrors the behavior the launch orientation had inline.
+ */
+export declare function decideReadyActions(i: ReadyInputs): ReadyDecision;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "document360-writer",
-  "version": "0.5.8",
+  "version": "0.5.10",
   "description": "Standalone documentation agent CLI. Reads your code, writes your docs. Specialized for Document360 publishing.",
   "type": "module",
   "bin": {