document360-writer 0.4.54 → 0.4.56

package/dist/commands/devhints.d.ts

@@ -1,20 +1,25 @@
 import type { SlashCommandResult } from './index.js';
 import type { ReplContext } from '../repl.js';
 /** Bump when the guide content changes — lets a future check detect a stale committed guide. */
-export declare const DEV_HINTS_GUIDE_VERSION = 1;
+export declare const DEV_HINTS_GUIDE_VERSION = 2;
 /**
- * The committed protocol guide the SOURCE repo's coding agent follows to write doc hints. It is
- * self-contained because that agent has none of d360-writer's context (no tools, no system prompt) —
- * everything it needs to produce a valid hint is here. The /devhints command writes this to
- * `.d360-writer/DEV-HINTS-GUIDE.md`; the paste block (below) just points the source agent at it.
+ * 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;
-/** `/devhints` — scaffold the hint channel: write the committed guide + emit a paste-ready block the
-    user adds to their SOURCE repo's CLAUDE.md/AGENTS.md so its coding agent starts leaving hints. */
+/** 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 emit a paste-ready block for the
+    SOURCE repo's CLAUDE.md/AGENTS.md so its coding agent onboards the docs agent and keeps it current. */
 export declare function devhintsCommand(_args: string[], ctx: ReplContext): Promise<SlashCommandResult>;
 /**
  * The paste-ready block for the user to add to their SOURCE repo's agent memory (CLAUDE.md/AGENTS.md).
- * A ONE-LINE pointer to the committed guide — not the protocol inline — so their memory stays lean and
- * we can improve the guide without anyone re-pasting. Mirrors renderTestidHandoff's bracketed shape.
+ * A pointer to the committed guide plus the ordered marching orders — not the protocol inline — so their
+ * memory stays lean and we can improve the guide without re-pasting. Mirrors renderTestidHandoff's shape.
  */
 export declare function renderDevHintsHandoff(): string[];

package/dist/d360/projectCli.d.ts

@@ -8,8 +8,9 @@ export declare function fetchProjects(cwd: string, profileName?: string): Promis
 }>;
 /** Match a project by exact name, name-prefix, or id-prefix (for `/project <name>`). */
 export declare function matchProject(projects: D360Project[], query: string): D360Project | undefined;
-/** Switching project invalidates any selected workspace — clear it so /workspace re-picks. */
-export declare function setProject(cwd: string, profileName: string, projectId: string): void;
+/** Switching project invalidates any selected workspace — clear it so /workspace re-picks. Caches the
+    project NAME for display (banner, workspace picker) so we never show a bare GUID. */
+export declare function setProject(cwd: string, profileName: string, projectId: string, projectName?: string): void;
 /** Non-interactive set-by-name (scriptable): `d360-writer project use <name>`. */
 export declare function runProjectUse(cwd: string, query: string, profileName?: string): Promise<number>;
 /** CLI / login path: list projects and prompt (interactive TTY). Persists the choice. */

package/dist/d360/workspaceCli.d.ts

@@ -3,6 +3,7 @@ import { type D360Workspace } from 'document360-engine';
 export declare function fetchWorkspaces(cwd: string, profileName?: string): Promise<{
     workspaces: D360Workspace[];
     projectId: string;
+    projectName?: string;
     profile: string;
     environment: string;
     current?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "document360-writer",
-  "version": "0.4.54",
+  "version": "0.4.56",
   "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.31",
+    "document360-engine": "^0.2.33",
     "ink": "^5.2.1",
     "picocolors": "^1.1.1",
     "react": "^18.3.1",