document360-writer 0.5.86 → 0.5.89

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "document360-writer",
-  "version": "0.5.86",
+  "version": "0.5.89",
   "description": "Standalone documentation agent CLI. Reads your code, writes your docs. Specialized for Document360 publishing.",
   "type": "module",
   "bin": {
@@ -8,7 +8,7 @@
     "d360-writer": "./dist/cli.js"
   },
   "files": [
-    "dist",
+    "dist/**/*.js",
     "README.md",
     "LICENSE"
   ],
@@ -34,7 +34,7 @@
     "@inquirer/prompts": "^8.4.3",
     "commander": "^14.0.3",
     "diff": "^8.0.4",
-    "document360-engine": "^0.2.106",
+    "document360-engine": "^0.2.107",
     "ink": "^5.2.1",
     "picocolors": "^1.1.1",
     "react": "^18.3.1",

package/dist/cli.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export {};

package/dist/commands/allowProd.d.ts

@@ -1,3 +0,0 @@
-import type { SlashCommandResult } from './index.js';
-import type { ReplContext } from '../repl.js';
-export declare function allowProdCommand(_args: string[], ctx: ReplContext): Promise<SlashCommandResult>;

package/dist/commands/audit.d.ts

@@ -1,2 +0,0 @@
-import type { SlashCommandResult } from './index.js';
-export declare function auditCommand(): Promise<SlashCommandResult>;

package/dist/commands/capture-setup.d.ts

@@ -1,12 +0,0 @@
-import type { SlashCommandResult } from './index.js';
-/** `/capture-setup` — synthesize the "stage this data" checklist from every article's
-    SCREENSHOT prerequisites. Forwards to the agent's capture-setup-checklist skill. */
-export declare function captureSetupCommand(): Promise<SlashCommandResult>;
-/**
- * After capture-setup writes `CAPTURE-TESTID-REQUESTS.json`, build a paste-ready hand-off the user
- * runs in THEIR OWN code repo (a different terminal) — d360-writer never edits product source, so
- * the test-ids are *requested*, not added. The prompt body is bracketed by `---` rules so the user
- * can copy exactly the part to paste into Claude Code. Returns null when there are no requests
- * (nothing to hand off) or the file is missing/unreadable.
- */
-export declare function renderTestidHandoff(cwd: string): string[] | null;

package/dist/commands/catchup.d.ts

@@ -1,63 +0,0 @@
-import { computeSyncStatus, planPull, applyPull, planImport, applyImport } from 'document360-engine';
-import type { ReplContext } from '../repl.js';
-import type { SlashCommandResult } from './index.js';
-export type PendingSummary = {
-    hints: number;
-    requests: number;
-    answers: number;
-    directives: number;
-};
-/** Deterministic local counts of queued work (hints + builder messages + owner directives). Drift is
-    network and is checked by the agent via d360_sync_status inside the prompt, not here. */
-export declare function pendingSummary(cwd: string): PendingSummary;
-/** A short human phrase for a pending summary, or null when nothing local is queued. */
-export declare function pendingLine(s: PendingSummary): string | null;
-export declare function parseCatchUpArgs(args: string[]): {
-    publish: boolean;
-};
-/** The consolidated staged prompt: trust → gather → decide → estimate/gate → write → close-loop → push. */
-export declare function buildCatchUpPrompt({ publish }: {
-    publish: boolean;
-}): string;
-/** Outcome of the Phase-0 portal reconcile (catch-up brings the portal fully down BEFORE the agent writes). */
-export type PortalReconcileResult = {
-    /** Repo-relative paths whose clean portal edits were pulled into local (lossless — local was unchanged). */
-    pulled: string[];
-    /** Repo-relative paths of NEW portal articles imported into local drafts (were untracked-remote). */
-    imported: string[];
-    /** Paths changed in BOTH places — left untouched for the user to resolve. */
-    conflicts: string[];
-    /** Per-article pull/import failures (left for /pull). */
-    failed: {
-        path: string;
-        error: string;
-    }[];
-    /** Set when the status check itself failed — catch-up still proceeds (the agent re-checks). */
-    error?: string;
-};
-/** Injectable seam (tests). Defaults to the real engine sync primitives. */
-export type ReconcileDeps = {
-    status: typeof computeSyncStatus;
-    plan: typeof planPull;
-    apply: typeof applyPull;
-    planImport: typeof planImport;
-    applyImport: typeof applyImport;
-};
-/**
- * Phase 0 of /catch-up — bring the portal FULLY down before the agent works, so "/catch-up" is the one
- * command a returning user needs (pull + process). Auto-pull clean `remote-ahead` (lossless — local
- * unchanged) AND import `untracked-remote` (new portal-authored articles → local drafts), the same way
- * bare /pull does; `conflict` is surfaced + skipped (never overwrite a copy we can't trust). Best-effort:
- * a status failure returns `{ error }` and catch-up proceeds (the agent's own d360_sync_status still gates).
- * The hidden feedback category is excluded upstream (computeSyncStatus), so its articles never import here.
- */
-export declare function reconcilePortal(opts: {
-    cwd: string;
-    profileName?: string;
-}, deps?: ReconcileDeps): Promise<PortalReconcileResult>;
-/** Human summary of the reconcile, each line tagged for tone (✓ ok · ℹ info · ⚠ warn). Empty when the
-    portal was already in sync (nothing to report). */
-export declare function reconcileSummaryLines(r: PortalReconcileResult): string[];
-/** Classic-REPL `/catch-up`. Reconciles the portal first (Phase 0), then forwards the queued-work prompt
-    (the double-check) — even with no local queue it still runs, to catch code changes the builder didn't hint. */
-export declare function catchupCommand(args: string[], ctx?: ReplContext): Promise<SlashCommandResult>;

package/dist/commands/clear.d.ts

@@ -1,3 +0,0 @@
-import type { SlashCommandResult } from './index.js';
-import type { ReplContext } from '../repl.js';
-export declare function clearCommand(_args: string[], ctx: ReplContext): Promise<SlashCommandResult>;

package/dist/commands/convert.d.ts

@@ -1,35 +0,0 @@
-import { type CostEstimate, type Partition, type PartitionResult } from 'document360-engine';
-import type { ReplContext } from '../repl.js';
-import type { SlashCommandResult } from './index.js';
-/** Parse /convert args: `--run`/`--yes` and `--scope <folder|path>` (or `--scope=…`). */
-export declare function parseConvertArgs(args: string[]): {
-    scope?: string;
-    run: boolean;
-};
-/** Keep only paths under `scope` (a folder prefix or an exact .md path). No scope → all. */
-export declare function applyScope(paths: string[], scope?: string): string[];
-/** Stat each repo-relative path for the estimator (missing files report 0 bytes → skipped). */
-export declare function sizeTargets(cwd: string, paths: string[]): {
-    path: string;
-    bytes: number;
-}[];
-/** The agent prompt for one partition. Mechanical + scoped + efficient — keep the agent from
-    over-exploring (the main driver of slow convert runs): no source reads, no re-verification. */
-export declare function buildConvertPrompt(partition: Partition): string;
-/** Preview lines for bare `/convert`: the partition plan + the cost band, before any spend. */
-export declare function previewLines(partitions: Partition[], estimate: CostEstimate, concurrency: number): string[];
-/**
- * Final summary after a run — a bookend to the opening "Converting N articles across M
- * partitions…" line: total articles + partitions completed, then the run's usage. Usage shows
- * dollars in API mode but OUTPUT TOKENS on a Claude subscription, where per-token cost is
- * meaningless to the user. `partitions` is the run plan, used to map each result back to its
- * article count (results carry only an index).
- */
-export declare function summaryLines(results: PartitionResult[], partitions: Partition[], usage: 'api' | 'subscription'): string[];
-/**
- * Classic-REPL `/convert` — parity with the TUI handler (App.tsx): bare `/convert` previews
- * (plan + cost band, no spend); `/convert --run` fans the tracked articles out across parallel
- * agents and prints compact per-partition status + a summary. Mid-run abort is TUI-only (Esc);
- * in the classic REPL, Ctrl+C exits the process.
- */
-export declare function convertCommand(args: string[], ctx: ReplContext): Promise<SlashCommandResult>;

package/dist/commands/devhints.d.ts

@@ -1,125 +0,0 @@
-import type { SlashCommandResult } from './index.js';
-import type { ReplContext } from '../repl.js';
-/**
- * The version of the WHOLE devhints script — the committed guide AND the copy-run prompt, which evolve
- * as one unit. Bump on any change to either. Embedded in the guide header, the run prompt, and the
- * on-disk handshake trace (devhints-state.json) so a future change is detectable: when the code version
- * is ahead of what the builder last completed, /devhints + /doctor tell the user to re-paste.
- *   v1 → original one-way hints. v2 → re-run-safe single-prompt onboarding.
- *   v3 → two-way messages (Part 3) + on-demand hand-off (Part 4) + version trace.
- *   v4 → the writer can send the builder a `request` (not just a question), e.g. an auto "re-run
- *        onboarding" note when this protocol version moves ahead of what the builder last completed.
- *   v5 → (reserved — shipped intermediate refinements).
- *   v6 → make the hand-off VISIBLE + state the boundary: the builder surfaces every hint drop in its
- *        reply (never silently) and NEVER writes/publishes the user docs itself — that's the docs agent's
- *        job. Keeps the dogfood/limitation signal honest and lets a human verify the hand-off happens.
- *   v7 → owner→docs directives channel: when the human types `@d360-writer <directive>` in the builder's
- *        session (a proactive doc ask like "document /review"), the builder APPENDS it as an `## [open]`
- *        block to `.d360-writer/directives.md` (create if absent) and commits — it does NOT action it
- *        (writing docs is the docs agent's job; it picks it up on its next /catch-up). The third comms
- *        channel, alongside builder hints/messages and portal feedback.
- */
-export declare const DEVHINTS_VERSION = 7;
-/**
- * The committed protocol guide the SOURCE repo's coding agent follows. Self-contained because that
- * agent has none of d360-writer's context. Two parts: (1) a ONE-TIME architecture brief that onboards
- * the docs agent — the builder, who holds the full intent, hands over what code alone can't tell a
- * writer; (2) ONGOING per-change doc hints. The /devhints command writes this to
- * `.d360-writer/DEV-HINTS-GUIDE.md`; the paste block points the source agent at it.
- */
-export declare function devHintsGuide(): string;
-/** The human-owned creator-notes template (scaffolded once, never overwritten). The builder reads it
-    first as authoritative; the docs agent reads it as authoritative intent. */
-export declare function creatorNotesTemplate(): string;
-/** `/devhints` — scaffold the dev→docs hand-off: write the committed guide + the architecture inbox
-    (with a human creator-notes template) + the hints inbox, then show ONE copy-run prompt the SOURCE
-    repo's coding agent executes to onboard the docs agent (writes the brief, persists the ongoing rule
-    into CLAUDE.md/AGENTS.md + commits, solicits tribal knowledge) — no manual file edits by the user. */
-/**
- * Scaffold the dev→docs hand-off artifacts (ongoing-hints inbox, architecture brief home + human
- * CREATOR-NOTES, two-way message mailbox, the committed guide, the version trace). Idempotent and
- * silent — it writes files and returns the builder's staleness so the caller can render the hand-off.
- * Shared by `/devhints`, `/init` (which now folds this in so there's no separate onboarding step),
- * and the TUI wizard finale.
- */
-export declare function scaffoldDevhints(cwd: string): DevhintsStaleness;
-export declare function devhintsCommand(_args: string[], ctx: ReplContext): Promise<SlashCommandResult>;
-/**
- * The ONE prompt the user copies and runs in their SOURCE repo's coding agent (Claude Code / Codex /
- * Cursor). It is self-acting: the agent does everything in one run — writes the architecture brief,
- * persists the ongoing-hints rule into the repo's agent-memory file + commits (so teammates inherit it),
- * and interactively asks the human for tribal knowledge → CREATOR-NOTES.md. Replaces the old "paste this
- * block into CLAUDE.md, commit, then tell your agent to follow it" three-step chain with a single copy-run
- * (Saravana, 2026-06-19 — remove every user step). The deep rubric stays in the committed guide, which
- * the prompt points the agent at, so the prompt stays short and the guide can improve without re-copying.
- *
- * RE-RUN SAFE (Saravana, 2026-06-19): the same prompt is pasted again whenever the product evolves, so it
- * is explicitly idempotent — each step CREATES if absent, RECONCILES if present, and never clobbers a
- * refined brief, duplicates the memory section, or deletes human notes. The final line reflects whether it
- * was a first-time setup or a refresh.
- */
-export declare function devHintsRunPrompt(): string;
-/** The devhints handshake trace (`.d360-writer/devhints-state.json`). `emitted*` = what d360-writer
-    last handed the builder; `completed*` = what the builder's agent last ran (stamped by the run prompt,
-    step 6). The gap between completedVersion and DEVHINTS_VERSION is what staleness detection reads. */
-export type DevhintsState = {
-    emittedVersion?: number;
-    emittedAt?: string;
-    completedVersion?: number;
-    completedAt?: string;
-    completedCommit?: string;
-};
-/** Read the handshake trace; null if absent or unparseable (treated as "never set up"). */
-export declare function readDevhintsState(cwd: string): DevhintsState | null;
-/** Record that /devhints just emitted the current version, preserving the builder's completion fields. */
-export declare function writeDevhintsEmitted(cwd: string, now: string): void;
-/** True once the builder has written its architecture brief — a non-CREATOR-NOTES `.md` in
-    `.d360-writer/architecture/`. Lets the wait-heartbeat distinguish "not started yet" from "working". */
-export declare function builderHasStarted(cwd: string): boolean;
-export type DevhintsStaleness = {
-    status: 'unset' | 'stale' | 'current';
-    completedVersion?: number;
-};
-/** Compare what the builder completed against the current script version. `unset` = the builder hasn't
-    run the hand-off (no completion stamp); `stale` = ran an older version; `current` = up to date. */
-export declare function devhintsStaleness(cwd: string): DevhintsStaleness;
-/** Subject prefix that marks the auto "re-run onboarding" request, so we never queue a duplicate. */
-export declare const ONBOARDING_REQUEST_MARKER = "Re-run dev\u2194docs onboarding (protocol v";
-export type DevhintsReconcileResult = {
-    guideRefreshed: boolean;
-    notifiedBuilder: boolean;
-    toVersion: number;
-    completedVersion?: number;
-};
-/**
- * Keep the dev↔docs onboarding protocol self-healing, with no human re-paste. Runs at launch when a
- * guide already exists (devhints is in use):
- *  - if the package's DEVHINTS_VERSION is ahead of what we last EMITTED → rewrite the committed guide +
- *    re-stamp `emitted` (the new protocol lands on disk on its own);
- *  - if it's ahead of what the builder COMPLETED → leave ONE `from: docs, kind: request` message in the
- *    mailbox with the run prompt embedded (idempotent: skip if an open onboarding request already exists),
- *    so the builder re-onboards on their next session.
- * Pure file ops, never throws; returns what it did so the wrapper can surface a one-line note.
- */
-export declare function reconcileDevhints(cwd: string, now?: string): DevhintsReconcileResult;
-/**
- * The RECURRING launch nudge to the human (e.g. Suprej): while the builder agent (John) is behind the
- * current protocol, show — on EVERY launch — a clear, actionable note that names THIS repo's path and
- * embeds the exact prompt to paste into the repo's coding agent. Returns [] when devhints isn't in use
- * here, or once the builder has caught up (so it self-stops). `cwd` is the repo path shown to the user.
- */
-export declare function renderBuilderUpdateNote(cwd: string): string[];
-/**
- * The INVERSE of devHintsRunPrompt: the copy-run prompt the user pastes into their builder after a
- * `/reset`, to undo the dev→docs hand-off and restore the repo to its pre-docs-agent state (the
- * `.d360-writer/` brief is already gone; this removes the rule the builder added to its agent memory).
- */
-export declare function devHintsCleanupPrompt(): string;
-/** The `/reset` builder-cleanup block: explains the leftover (the builder's agent-memory edit, which
-    reset deliberately can't touch) and shows the copy-run cleanup prompt. */
-export declare function renderResetCleanup(): string[];
-/**
- * The `/devhints` screen: confirms what was scaffolded, then shows the single copy-run prompt
- * (devHintsRunPrompt) and the closing "come back and run" guidance. One prompt, zero manual file edits.
- */
-export declare function renderDevHintsHandoff(stale?: DevhintsStaleness): string[];

package/dist/commands/doctor.d.ts

@@ -1,13 +0,0 @@
-import type { ReplContext } from '../repl.js';
-import type { SlashCommandResult } from './index.js';
-export type DoctorCheck = {
-    level: 'ok' | 'warn' | 'fail';
-    label: string;
-    detail?: string;
-    fix?: string;
-};
-/** Health checks with the exact fix command per failure — the writer analog of
-    capture's doctor. Shared by the `doctor` CLI subcommand and /doctor. */
-export declare function runDoctorChecks(cwd: string): Promise<DoctorCheck[]>;
-export declare function renderDoctorChecks(checks: DoctorCheck[]): string[];
-export declare function doctorCommand(_args: string[], ctx: ReplContext): Promise<SlashCommandResult>;

package/dist/commands/document.d.ts

@@ -1,19 +0,0 @@
-import type { ReplContext } from '../repl.js';
-import type { SlashCommandResult } from './index.js';
-/** Open `request` messages (the builder's explicit "please document X") awaiting the docs agent. */
-export declare function openRequestCount(cwd: string): number;
-/** Split `--publish` off the args; the rest is the free-text description of what changed. */
-export declare function parseDocumentArgs(args: string[]): {
-    publish: boolean;
-    what: string;
-};
-/** The prompt driving the document-handoff skill. `what` is the builder's description (empty → act on
-    the open request messages in the inbox). `publish` appends a draft-then-publish instruction. */
-export declare function buildDocumentPrompt(what: string, publish?: boolean): string;
-declare const NO_REQUESTS_HINT = "Nothing to document yet. Say what changed: /document <what you shipped> \u2014 or have the builder drop a request via their /devhints hand-off.";
-/**
- * Classic-REPL `/document`: with text → document it; bare with open requests → process them; bare with
- * nothing → tell the user how to describe the work.
- */
-export declare function documentCommand(args: string[], ctx?: ReplContext): Promise<SlashCommandResult>;
-export { NO_REQUESTS_HINT };

package/dist/commands/draft.d.ts

@@ -1,27 +0,0 @@
-import type { ReplContext } from '../repl.js';
-import type { SlashCommandResult } from './index.js';
-/** A feature available to draft: a subfolder of `.d360-writer/input/` holding ≥1 input doc. */
-export type DraftFeature = {
-    name: string;
-    docCount: number;
-};
-/** List the feature subfolders under `.d360-writer/input/` (each with ≥1 PRD/spec doc). Sorted.
-    Loose docs directly in input/ (no subfolder) surface as the synthetic feature "" (root). */
-export declare function listInputFeatures(cwd: string): {
-    features: DraftFeature[];
-    looseDocs: number;
-};
-/** Resolve a `/draft <selector>` to a feature subfolder: exact → prefix → fuzzy (substring), case-
-    insensitive. Returns the matched feature name, or null when nothing matches (caller treats the
-    selector as a free-text hint instead). */
-export declare function matchFeature(features: DraftFeature[], selector: string): string | null;
-/** The prompt that drives the draft-from-prd skill for a resolved scope. `feature` is the subfolder
-    (or '' for loose root docs); `hint` is the user's free-text framing when no subfolder matched. */
-export declare function buildDraftPrompt(feature: string, hint?: string): string;
-declare const EMPTY_INPUT_HINT = "No input docs found. Drop this feature's PRDs/specs in .d360-writer/input/<feature>/ (.md or .pdf), then run /draft.";
-/**
- * Classic-REPL `/draft`: resolve the feature, then forward the draft-from-prd prompt to the agent.
- * Multiple features + no selector → list them and ask (the TUI shows a picker; classic prints the list).
- */
-export declare function draftCommand(args: string[], ctx?: ReplContext): Promise<SlashCommandResult>;
-export { EMPTY_INPUT_HINT };

package/dist/commands/exit.d.ts

@@ -1,2 +0,0 @@
-import type { SlashCommandResult } from './index.js';
-export declare function exitCommand(): Promise<SlashCommandResult>;

package/dist/commands/genre.d.ts

@@ -1,3 +0,0 @@
-import type { ReplContext } from '../repl.js';
-import type { SlashCommandResult } from './index.js';
-export declare function genreCommand(args: string[], ctx: ReplContext): Promise<SlashCommandResult>;

package/dist/commands/help.d.ts

@@ -1,2 +0,0 @@
-import type { SlashCommandResult } from './index.js';
-export declare function helpCommand(): Promise<SlashCommandResult>;

package/dist/commands/inbox.d.ts

@@ -1,11 +0,0 @@
-import type { ReplContext } from '../repl.js';
-import type { SlashCommandResult } from './index.js';
-/** Count of open builder messages addressed to the docs agent — drives the ambient nudge + bare /inbox. */
-export declare function openForDocsCount(cwd: string): number;
-/** The prompt that drives inbox processing. Generic over the action so it composes with the
-    document-handoff skill (Phase B) for requests and gap-analysis's update logic for answers. */
-export declare function buildInboxPrompt(): string;
-/**
- * Classic-REPL `/inbox`: if there are open messages, forward the processing prompt; otherwise say so.
- */
-export declare function inboxCommand(_args: string[], ctx?: ReplContext): Promise<SlashCommandResult>;

package/dist/commands/index.d.ts

@@ -1,28 +0,0 @@
-import type { ReplContext } from '../repl.js';
-export type SlashCommandResult = {
-    kind: 'continue';
-} | {
-    kind: 'exit';
-} | {
-    kind: 'clear';
-} | {
-    kind: 'resume';
-    uuid: string;
-    name: string;
-} | {
-    kind: 'allow-prod';
-}
-/** `display` is the effective command line (e.g. "/publish --all") — transcripts
-    and session titles show it instead of the expanded prompt template (CC-style). */
- | {
-    kind: 'forward-to-agent';
-    prompt: string;
-    display?: string;
-};
-export type SlashCommand = (args: string[], ctx: ReplContext) => Promise<SlashCommandResult>;
-export declare const slashCommands: Record<string, SlashCommand>;
-export declare function isSlashCommand(line: string): boolean;
-export declare function parseSlash(line: string): {
-    name: string;
-    args: string[];
-} | null;

package/dist/commands/init.d.ts

@@ -1,9 +0,0 @@
-import type { SlashCommandResult } from './index.js';
-/** Non-interactive scaffold with sensible defaults — the TUI path (inquirer can't
-    share stdin with Ink). The classic REPL/CLI keeps the interactive flow below. */
-export declare function scaffoldInit(cwd: string, env?: string): {
-    created: boolean;
-    path: string;
-    profileName: string;
-};
-export declare function initCommand(): Promise<SlashCommandResult>;

package/dist/commands/lint.d.ts

@@ -1,8 +0,0 @@
-import { type LintFinding } from 'document360-engine';
-import type { ReplContext } from '../repl.js';
-import type { SlashCommandResult } from './index.js';
-/** Group findings by article into printable lines (shared by classic + TUI). */
-export declare function lintReportLines(findings: LintFinding[]): string[];
-/** The agent prompt for `/check --fix`: correct each finding in place, grounded in source, no new issues. */
-export declare function buildLintFixPrompt(findings: LintFinding[]): string;
-export declare function lintCommand(args: string[], ctx: ReplContext): Promise<SlashCommandResult>;

package/dist/commands/login.d.ts

@@ -1,4 +0,0 @@
-import type { SlashCommand } from './index.js';
-/** /login — browser OAuth without leaving the REPL. Tokens are re-read from the
-    store on every API call, so the running agent session heals in place. */
-export declare const loginCommand: SlashCommand;

package/dist/commands/logout.d.ts

@@ -1,5 +0,0 @@
-import type { SlashCommandResult } from './index.js';
-import type { ReplContext } from '../repl.js';
-/** `/logout` — sign out of the active profile and clear its project/workspace selection, so the
-    next /login starts project selection from scratch (Claude Code parity + the "start over" lever). */
-export declare function logoutCommand(_args: string[], ctx: ReplContext): Promise<SlashCommandResult>;

package/dist/commands/logsCli.d.ts

@@ -1,2 +0,0 @@
-/** `d360-writer logs` — the one command to give a customer reporting a problem. */
-export declare function runLogs(): void;

package/dist/commands/mcp.d.ts

@@ -1,2 +0,0 @@
-import type { SlashCommandResult } from './index.js';
-export declare function mcpCommand(args: string[]): Promise<SlashCommandResult>;

package/dist/commands/model.d.ts

@@ -1,17 +0,0 @@
-import { type ResolvedModel } from 'document360-engine';
-import type { ReplContext } from '../repl.js';
-import type { SlashCommandResult } from './index.js';
-export declare function describeModelSource(r: ResolvedModel): string;
-/** Set or clear the personal (user-config) model. Returns the status lines plus
-    the `effective` model to push into the LIVE session via setModel() — always
-    concrete now (auto resolves to the docs-right Sonnet default; the dev
-    environment's Claude Code settings model never leaks in — SNAG-0262).
-    Shared by the REPL command and the TUI case. */
-export declare function applyModelChange(cwd: string, arg: string): {
-    lines: string[];
-    changed: boolean;
-    effective: string | undefined;
-};
-/** /model — interactive picker (TTY) or status display; /model <name> sets the
-    personal (user-config) model; /model default clears it. Mirrors Claude Code's /model. */
-export declare function modelCommand(args: string[], ctx: ReplContext): Promise<SlashCommandResult>;

package/dist/commands/profile.d.ts

@@ -1,6 +0,0 @@
-import type { SlashCommandResult } from './index.js';
-import type { ReplContext } from '../repl.js';
-/** Create a profile from a known environment preset. Returns null on success,
-    or the error line. Shared by the REPL command and the TUI case. */
-export declare function addProfile(cwd: string, name?: string, env?: string): string | null;
-export declare function profileCommand(args: string[], ctx: ReplContext): Promise<SlashCommandResult>;

package/dist/commands/project.d.ts

@@ -1,3 +0,0 @@
-import type { SlashCommandResult } from './index.js';
-import type { ReplContext } from '../repl.js';
-export declare function projectCommand(_args: string[], ctx: ReplContext): Promise<SlashCommandResult>;

package/dist/commands/publish.d.ts

@@ -1,57 +0,0 @@
-import { type Partition, type PartitionResult, type SyncEntryState } from 'document360-engine';
-import type { ReplContext } from '../repl.js';
-import type { SlashCommandResult } from './index.js';
-/** Partitions publishing at once. D360 API rate limits → low, same as /convert. */
-export declare const PUBLISH_CONCURRENCY = 3;
-export declare function buildPublishPrompt(path: string): string;
-/** Publish-picker rows: articles the sync state says are worth pushing. */
-export declare const PUBLISH_CANDIDATE_LABEL: Partial<Record<SyncEntryState['status'], string>>;
-export declare function publishCandidates(entries: SyncEntryState[]): {
-    path: string;
-    label: string;
-}[];
-/** Count of files that already exist on Document360 but aren't linked (link candidates), so the /publish
-    flows can tell the user why they were left out instead of silently dropping them. */
-export declare function linkCandidateCount(entries: SyncEntryState[]): number;
-/** A one-line post-publish note about relative cross-article links whose target isn't published yet — they
-    render as plain text until then (by design) and resolve to live links once the target publishes. Returns
-    null when there are none. Reassures the operator that plain-text links aren't broken (dogfood s-205). */
-export declare function crossLinkPendingLine(cwd: string, profileName?: string): string | null;
-/** A row in the grouped /publish picker: "all", a category (publishes all its candidates), or one
-    article. `paths` is what gets published when the row is chosen (one for an article, many otherwise). */
-export type PublishRow = {
-    kind: 'all' | 'category' | 'article';
-    label: string;
-    paths: string[];
-    /** Article rows render indented under their category; gray status note (new/modified) sits beside. */
-    indent: boolean;
-    note?: string;
-};
-/**
- * Build the grouped publish picker: a "publish all" row, then each category (sorted) as a selectable
- * parent that publishes ALL its candidate articles, with its articles listed beneath as indented,
- * individually-selectable rows. Both categories and articles are pickable (SNAG-0135).
- */
-export declare function buildPublishRows(candidates: {
-    path: string;
-    label: string;
-}[]): PublishRow[];
-/** The publish prompt for ONE partition (a category's worth of articles). The bulk `/publish --all`
-    fans these out across parallel agents (engine runPartitioned) so no single agent context carries
-    the whole repo — the SNAG-0128 crash (a 38-article single turn OOM'd the SDK subprocess). */
-export declare function buildBulkPublishPrompt(paths: string[]): string;
-/** Final summary after a partitioned publish run — bookends the opening line. Usage shows dollars in
-    API mode but OUTPUT TOKENS on a Claude subscription (per-token cost is meaningless there). */
-export declare function publishSummaryLines(results: PartitionResult[], partitions: Partition[], usage: 'api' | 'subscription'): string[];
-/**
- * Classic-REPL bulk publish: fan the candidate articles out across parallel agents (partitioned by
- * category), printing compact per-partition status + a summary. Mirrors convertCommand. Mid-run abort
- * is TUI-only (Esc); Ctrl+C exits the REPL here. Resumable: each article's publish is recorded as it
- * completes, so a re-run skips what's already in sync.
- */
-export declare function runBulkPublishClassic(ctx: ReplContext, paths: string[]): Promise<SlashCommandResult>;
-/** Repo-relative paths of `articlePath`'s related articles that aren't published yet — its
-    `## Related articles` targets intersected with the current publish candidates. Deterministic, so
-    the post-publish offer lists ALL of them (the agent's prose only listed some — SNAG-0136). */
-export declare function unpublishedRelated(cwd: string, profileName: string | undefined, articlePath: string): Promise<string[]>;
-export declare function publishCommand(args: string[], ctx?: ReplContext): Promise<SlashCommandResult>;

package/dist/commands/pull.d.ts

@@ -1,45 +0,0 @@
-import type { ReplContext } from '../repl.js';
-import type { SlashCommandResult } from './index.js';
-/**
- * /pull — bring Document360 down into the local docs. ONE verb, ONE direction (push stays /publish).
- *   /pull              pull every clean portal edit + import every NEW portal article, then report drift
- *   /pull <path>       pull (or conflict-resolve) one article after a reviewed diff
- *   /pull --status     read-only drift report (no writes)
- *   /pull --baseline   set a sync baseline for tracked-but-not-yet-compared articles
- *   /pull --compare    (diagnostic) check the manifest sees the same articles as the per-article path
- * No agent turn, no tokens — direct engine calls.
- */
-export declare function pullCommand(args: string[], ctx: ReplContext): Promise<SlashCommandResult>;
-/** Result of a bare /pull — the down-direction reconcile (shared by the classic REPL + the TUI). */
-export type PullDownResult = {
-    /** Repo-relative paths whose clean portal edits were pulled into local. */
-    pulled: string[];
-    /** NEW portal articles imported into local files. */
-    imported: {
-        title: string;
-        path: string;
-    }[];
-    /** Paths changed in BOTH places — left untouched for the user to resolve. */
-    conflicts: string[];
-    /** Count of local-only changes (local-ahead + new-here) that go UP via /publish. */
-    toPublish: number;
-    /** Per-item failures (a pull or import that threw). */
-    failed: {
-        ref: string;
-        error: string;
-    }[];
-};
-/**
- * Bare /pull: bring Document360 down. Auto-pull every clean `remote-ahead` (lossless — local unchanged),
- * import every `untracked-remote` new portal article into a local draft, and tally what's left (conflicts
- * to resolve, local changes to /publish). Pure orchestration over the engine sync primitives — no UI.
- */
-export declare function pullDown(opts: {
-    cwd: string;
-    profileName?: string;
-}): Promise<PullDownResult>;
-/** Human summary of a bare /pull, each line tagged for tone. Always returns ≥1 line. */
-export declare function pullDownLines(r: PullDownResult): {
-    text: string;
-    tone: 'ok' | 'info' | 'warn';
-}[];

package/dist/commands/rename.d.ts

@@ -1,5 +0,0 @@
-import type { SlashCommandResult } from './index.js';
-import type { ReplContext } from '../repl.js';
-/** Drop one layer of matching wrapping quotes — `/rename "my name"` shouldn't store the quotes. */
-export declare function stripWrappingQuotes(s: string): string;
-export declare function renameCommand(args: string[], ctx: ReplContext): Promise<SlashCommandResult>;

package/dist/commands/reorder.d.ts

@@ -1,8 +0,0 @@
-import type { ReplContext } from '../repl.js';
-import type { SlashCommandResult } from './index.js';
-/** Build the /reorder prompt + display, or null when the repo isn't configured. */
-export declare function buildReorder(cwd: string, args: string[]): {
-    prompt: string;
-    display: string;
-} | null;
-export declare function reorderCommand(args: string[], ctx: ReplContext): Promise<SlashCommandResult>;

package/dist/commands/reset.d.ts

@@ -1,31 +0,0 @@
-import type { ReplContext } from '../repl.js';
-import type { SlashCommandResult } from './index.js';
-/**
- * Hard gate on what /reset may delete. d360-writer owns ONLY `.d360-writer/` (+ pre-consolidation root
- * dot-files), so anything outside `.d360-writer/` (except our own dot-files) is refused — no matter what
- * the config says or how a target was computed. Cheap insurance against a bad config pointing the docs
- * dir at a real repo folder and nuking it. (No "gold set" anymore — see CLAUDE.md; the guard stays
- * because refusing to rm a repo-root folder is just good hygiene.)
- */
-export declare function isResettable(rel: string): boolean;
-/** Repo-relative paths that exist and would be removed by /reset — strictly within `.d360-writer/`
-    (+ legacy root dot-files). NEVER a repo-root docs folder (refused by isResettable, no matter the config). */
-export declare function resetTargets(cwd: string): string[];
-/** Delete each target (recursive, force) — but re-check isResettable on every path as a final
-    safety net, so a non-resettable path (e.g. any repo-root folder) can never be deleted even if
-    it somehow reached this list. Returns what was removed, refused, and what failed. */
-export declare function performReset(cwd: string, targets: string[]): {
-    removed: string[];
-    failed: {
-        path: string;
-        error: string;
-    }[];
-};
-/** Uncommitted doc hints (`.d360-writer/hints/`) that a reset would destroy. */
-export declare function uncommittedHintCount(cwd: string): number;
-/** Uncommitted two-way messages (`.d360-writer/messages/`) that a reset would destroy. */
-export declare function uncommittedMessageCount(cwd: string): number;
-/** The destructive preview shown before the typed-name confirmation. */
-export declare function resetPreviewLines(cwd: string, targets: string[]): string[];
-/** `/reset` [DANGER] — classic REPL: preview → typed-name confirmation → delete. */
-export declare function resetCommand(_args: string[], ctx: ReplContext): Promise<SlashCommandResult>;