document360-writer 0.5.25 → 0.5.26

package/dist/commands/catchup.d.ts

@@ -26,7 +26,7 @@ export type PortalReconcileResult = {
     conflicts: string[];
     /** Titles of NEW portal articles not local yet — surfaced, not imported (import lands with P3/manifest). */
     untrackedRemote: string[];
-    /** Per-article pull failures (left for /sync pull). */
+    /** Per-article pull failures (left for /pull). */
     failed: {
         path: string;
         error: string;

package/dist/commands/pull.d.ts

@@ -0,0 +1,45 @@
+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/lib/commandSuggest.d.ts

@@ -1,6 +1,6 @@
 /**
  * Quick-run options: when an agent turn ends by suggesting slash commands (e.g. the
- * gap-analysis trust gate offering `/sync pull <path>` vs `/publish <path>`), the TUI
+ * gap-analysis trust gate offering `/pull <path>` vs `/publish <path>`), the TUI
  * lets the user press 1-N to fill the command instead of retyping it. Only standalone
  * command lines count — a command mentioned mid-sentence is prose, not an option.
  */

package/dist/lib/nextActions.d.ts

@@ -10,7 +10,7 @@ export type ReadyInputs = {
     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. */
+        where you left off" → /write lead so a half-done generation isn't buried under /audit + /pull. */
     pendingWrites: number;
     /** Commits on HEAD since the last `/audit` marker (0 when never audited or not a git repo). */
     behind: number;

package/dist/lib/quickOptions.d.ts

@@ -5,7 +5,7 @@ export declare function argOf(cmd: string): string;
  * options that should remain:
  *  - If the command IS one of the offered suggestions (same command, or an alternative over the same
  *    argument), the user is following the offered flow → keep the siblings, dropping the executed one
- *    and its argument-alternatives (SNAG-0049: running "/sync pull X" must not wipe a pending "/audit").
+ *    and its argument-alternatives (SNAG-0049: running "/pull X" must not wipe a pending "/audit").
  *  - Otherwise the user went off-script (e.g. "/reset" while "/publish --all" was offered) → clear all,
  *    so a now-irrelevant suggestion can't linger into the new context (SNAG-0127).
  */

package/dist/tui/catalog.d.ts

@@ -12,6 +12,6 @@ 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 `[...]`
-    brackets). "/rename <name>" requires one; "/sync [pull <path>|--all]" does not —
+    brackets). "/rename <name>" requires one; "/pull [<path> | --status]" does not —
     palette Enter must submit the latter bare instead of waiting for input forever. */
 export declare function requiresArgument(usage: string): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "document360-writer",
-  "version": "0.5.25",
+  "version": "0.5.26",
   "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.67",
+    "document360-engine": "^0.2.68",
     "ink": "^5.2.1",
     "picocolors": "^1.1.1",
     "react": "^18.3.1",

package/dist/commands/sync.d.ts

@@ -1,8 +0,0 @@
-import type { ReplContext } from '../repl.js';
-import type { SlashCommandResult } from './index.js';
-/**
- * /sync — deterministic local<->Document360 drift report (no agent turn, no tokens).
- * /sync pull <path> | --all — fetch portal edits into local markdown after a
- * reviewed diff. Push direction stays /publish.
- */
-export declare function syncCommand(args: string[], ctx: ReplContext): Promise<SlashCommandResult>;