@fractalsynapse/dsh-chapters 0.0.0-stage → 0.2.20

package/lib/commands.d.ts

@@ -0,0 +1,52 @@
+import { type SyncScheduler } from './sync.ts';
+import type { DomainLike } from './store.ts';
+import type { ToolsCtx } from './tools.ts';
+import type { PromptCommandSurface } from './prompt.ts';
+import { type ModelsIo } from './models-command.ts';
+import type { SaveSessionConfig } from './save-core.ts';
+import { type RegistryStore } from './store.ts';
+/** Structural slice of EnrichWiring the commands need (keeps queue types out). */
+export interface EnrichCommandSurface {
+    runNow(cwd?: string): Promise<{
+        processed: number;
+        remaining: number;
+    }>;
+    setModelOverride(v: string | null): Promise<void>;
+    modelOverride(): string | null;
+    statusLine(): string;
+    pendingCount(): Promise<number>;
+}
+export interface HostCommandsConfig {
+    artifactStoreRoot: string;
+    harnessId: string;
+    /** The sync scheduler to arm after a link (record §5). */
+    scheduler?: SyncScheduler;
+    /** P2 enrichment command surface (host plane; manual-drain semantics). */
+    enrich?: EnrichCommandSurface;
+    /** #173: model-catalog discovery, re-read per invocation (settings mutate under it). */
+    models?: () => ModelsIo;
+    /** P3 rule lifecycle family, bound to a workspace (S2 module underneath). */
+    rules?: (cwd: string, args: string, sessionId?: string) => Promise<{
+        kind: 'success' | 'error';
+        text: string;
+    }>;
+    /** Door 5 (issue #47): whether subagent settlements auto-archive. Reported in
+     *  /chapters-status because it runs WITHOUT a human seeing it happen. */
+    subagentAutoSave?: boolean;
+    /** #71: prompt recommendations surface (host plane; pull transport — the
+     *  client composer ghost executes `suggest`). Reported by /chapters-status. */
+    prompt?: PromptCommandSurface;
+    /** §7.8: fed to `resolveProject` so the identity line reports the SAME key the
+     * plugin binds by, not a naive re-derivation. */
+    projectKeyOverride?: string;
+    /** #255: the plane's registry store handle — `/chapters-remove` mutates through it
+     * (one serialized section per row, #59). Absent ⇒ the command refuses cleanly. */
+    store?: RegistryStore;
+    /** #255: cap for removal report/print arms. Reuses the repair report row — one
+     * knob for "how many lines may a command print", not two (#117 family). */
+    reportMaxLines?: number;
+    /** #255: the door plane's assembled render/save config — `restore` re-derives spans through
+     * the SAME save core with the SAME thresholds (one assembly, index.ts shares it; #90). */
+    save?: SaveSessionConfig;
+}
+export declare function registerHostCommands(ctx: ToolsCtx, domain: DomainLike, config: HostCommandsConfig): () => void;