document360-writer 0.1.0

package/dist/commands/save.d.ts

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

package/dist/commands/save.js

@@ -0,0 +1,29 @@
+import { error, ok, warn } from '../lib/colors.js';
+import { sessionPath, sessionsDir, ensureDir } from '../lib/paths.js';
+import { existsSync, copyFileSync } from 'node:fs';
+export async function saveCommand(args) {
+    const name = args[0];
+    if (!name) {
+        console.log(error('Usage: /save <name>'));
+        return { kind: 'continue' };
+    }
+    ensureDir(sessionsDir());
+    const dest = sessionPath(name);
+    const transcript = locateActiveTranscript();
+    if (!transcript) {
+        console.log(warn('No active session transcript was found to copy.'));
+        console.log(warn('The Agent SDK is configured with settingSources: [] for SDK isolation, so transcripts are not persisted automatically in this build.'));
+        console.log(warn(`Manual save target: ${dest}`));
+        return { kind: 'continue' };
+    }
+    copyFileSync(transcript, dest);
+    console.log(ok(`✓ Saved session to ${dest}`));
+    return { kind: 'continue' };
+}
+function locateActiveTranscript() {
+    const candidate = process.env.D360_WRITER_TRANSCRIPT;
+    if (candidate && existsSync(candidate))
+        return candidate;
+    return null;
+}
+//# sourceMappingURL=save.js.map

package/dist/commands/save.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"save.js","sourceRoot":"","sources":["../../src/commands/save.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEnD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAc;IAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACrB,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC;QAC1C,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAC9B,CAAC;IAED,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;IACzB,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAE/B,MAAM,UAAU,GAAG,sBAAsB,EAAE,CAAC;IAC5C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC,CAAC;QACrE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,sIAAsI,CAAC,CAAC,CAAC;QAC1J,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC,CAAC;QACjD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAC9B,CAAC;IAED,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAC/B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC,CAAC;IAC9C,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AAC9B,CAAC;AAED,SAAS,sBAAsB;IAC7B,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;IACrD,IAAI,SAAS,IAAI,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IACzD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/commands/screenshot.d.ts

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

package/dist/commands/screenshot.js

@@ -0,0 +1,20 @@
+import { error } from '../lib/colors.js';
+export async function screenshotCommand(args) {
+    const id = args[0];
+    if (!id) {
+        console.log(error('Usage: /screenshot <placeholder-id>'));
+        return { kind: 'continue' };
+    }
+    const prompt = [
+        `Run the emit-screenshot-spec skill for placeholder id: ${id}`,
+        '',
+        'Steps you must follow:',
+        '1. Locate the SCREENSHOT HTML comment block with this id across user-docs/**/*.md.',
+        '2. Translate the placeholder.steps into Playwright actions using STABLE selectors only (data-testid > aria-label > role+name > visible text). If no stable selector is available for a required action, write `test.skip(...)` plus a TODO comment naming the React component that needs a data-testid.',
+        '3. Write the spec file to <captureDir>/<id>.spec.ts. Use `import { test } from "@playwright/test"` and `import { waitPastLogin, dumpAnnotations, type Placeholder } from "document360-capture/helpers"`.',
+        "4. Use process.env.CAPTURE_START_URL and process.env.CAPTURE_AUTH_BOUNDARY (these are injected at run time by document360-capture; do not hardcode them).",
+        "5. Report the path of the generated spec and any TODOs from missing selectors.",
+    ].join('\n');
+    return { kind: 'forward-to-agent', prompt };
+}
+//# sourceMappingURL=screenshot.js.map

package/dist/commands/screenshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.js","sourceRoot":"","sources":["../../src/commands/screenshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAGzC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAc;IACpD,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACnB,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC,CAAC;QAC1D,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAC9B,CAAC;IACD,MAAM,MAAM,GAAG;QACb,0DAA0D,EAAE,EAAE;QAC9D,EAAE;QACF,wBAAwB;QACxB,oFAAoF;QACpF,ySAAyS;QACzS,0MAA0M;QAC1M,2JAA2J;QAC3J,gFAAgF;KACjF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,CAAC;AAC9C,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,40 @@
+export type ProjectConfig = {
+    projectId: string;
+    d360?: {
+        projectId?: string;
+        projectVersionId?: string;
+        helpCenterBaseUrl?: string;
+    };
+    captureDir?: string;
+    outputDir?: string;
+    authoritativeSourceFiles?: string[];
+    terminologyGlossary?: Record<string, string>;
+    defaultModel?: string;
+};
+export type UserConfig = {
+    defaultModel?: string;
+    autoUpdate?: boolean;
+};
+export type McpServerEntry = {
+    type: 'stdio';
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+} | {
+    type: 'http';
+    url: string;
+    headers?: Record<string, string>;
+} | {
+    type: 'sse';
+    url: string;
+    headers?: Record<string, string>;
+};
+export type UserMcpConfig = {
+    servers: Record<string, McpServerEntry>;
+};
+export declare function readProjectConfig(cwd?: string): ProjectConfig | null;
+export declare function writeProjectConfig(cfg: ProjectConfig, cwd?: string): void;
+export declare function readUserConfig(): UserConfig;
+export declare function writeUserConfig(cfg: UserConfig): void;
+export declare function readMcpConfig(): UserMcpConfig;
+export declare function writeMcpConfig(cfg: UserMcpConfig): void;

package/dist/config.js

@@ -0,0 +1,42 @@
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { projectConfigPath, userConfigPath, userMcpConfigPath, userDir, ensureDir, } from './lib/paths.js';
+export function readProjectConfig(cwd = process.cwd()) {
+    const path = projectConfigPath(cwd);
+    if (!existsSync(path))
+        return null;
+    return JSON.parse(readFileSync(path, 'utf8'));
+}
+export function writeProjectConfig(cfg, cwd = process.cwd()) {
+    writeFileSync(projectConfigPath(cwd), JSON.stringify(cfg, null, 2) + '\n', 'utf8');
+}
+export function readUserConfig() {
+    const path = userConfigPath();
+    if (!existsSync(path))
+        return {};
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        return {};
+    }
+}
+export function writeUserConfig(cfg) {
+    ensureDir(userDir());
+    writeFileSync(userConfigPath(), JSON.stringify(cfg, null, 2) + '\n', 'utf8');
+}
+export function readMcpConfig() {
+    const path = userMcpConfigPath();
+    if (!existsSync(path))
+        return { servers: {} };
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        return { servers: {} };
+    }
+}
+export function writeMcpConfig(cfg) {
+    ensureDir(userDir());
+    writeFileSync(userMcpConfigPath(), JSON.stringify(cfg, null, 2) + '\n', 'utf8');
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,OAAO,EACP,SAAS,GACV,MAAM,gBAAgB,CAAC;AA8BxB,MAAM,UAAU,iBAAiB,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IAC3D,MAAM,IAAI,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAkB,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAkB,EAAE,MAAc,OAAO,CAAC,GAAG,EAAE;IAChF,aAAa,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC;IAC9B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAe,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAe;IAC7C,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;IACrB,aAAa,CAAC,cAAc,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,MAAM,IAAI,GAAG,iBAAiB,EAAE,CAAC;IACjC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC9C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAkB,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACzB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAkB;IAC/C,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;IACrB,aAAa,CAAC,iBAAiB,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;AAClF,CAAC"}

package/dist/lib/colors.d.ts

@@ -0,0 +1,8 @@
+export declare const banner: (s: string) => string;
+export declare const dim: (s: string) => string;
+export declare const error: (s: string) => string;
+export declare const warn: (s: string) => string;
+export declare const ok: (s: string) => string;
+export declare const accent: (s: string) => string;
+export declare const muted: (s: string) => string;
+export declare const bold: (s: string) => string;

package/dist/lib/colors.js

@@ -0,0 +1,10 @@
+import pc from 'picocolors';
+export const banner = (s) => pc.bold(pc.cyan(s));
+export const dim = (s) => pc.dim(s);
+export const error = (s) => pc.red(s);
+export const warn = (s) => pc.yellow(s);
+export const ok = (s) => pc.green(s);
+export const accent = (s) => pc.cyan(s);
+export const muted = (s) => pc.gray(s);
+export const bold = (s) => pc.bold(s);
+//# sourceMappingURL=colors.js.map

package/dist/lib/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../../src/lib/colors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACjE,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACpD,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACtD,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACxD,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACxD,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACvD,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC"}

package/dist/lib/messageQueue.d.ts

@@ -0,0 +1,9 @@
+import type { SDKUserMessage } from '@anthropic-ai/claude-agent-sdk';
+export declare class UserMessageQueue implements AsyncIterable<SDKUserMessage> {
+    private resolvers;
+    private buffer;
+    private closed;
+    push(content: string): void;
+    close(): void;
+    [Symbol.asyncIterator](): AsyncIterator<SDKUserMessage>;
+}

package/dist/lib/messageQueue.js

@@ -0,0 +1,40 @@
+export class UserMessageQueue {
+    resolvers = [];
+    buffer = [];
+    closed = false;
+    push(content) {
+        if (this.closed)
+            return;
+        const msg = {
+            type: 'user',
+            message: { role: 'user', content },
+            parent_tool_use_id: null,
+        };
+        const resolver = this.resolvers.shift();
+        if (resolver)
+            resolver(msg);
+        else
+            this.buffer.push(msg);
+    }
+    close() {
+        this.closed = true;
+        for (const r of this.resolvers)
+            r(null);
+        this.resolvers = [];
+    }
+    async *[Symbol.asyncIterator]() {
+        while (true) {
+            if (this.buffer.length > 0) {
+                yield this.buffer.shift();
+                continue;
+            }
+            if (this.closed)
+                return;
+            const next = await new Promise(r => this.resolvers.push(r));
+            if (next === null)
+                return;
+            yield next;
+        }
+    }
+}
+//# sourceMappingURL=messageQueue.js.map

package/dist/lib/messageQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageQueue.js","sourceRoot":"","sources":["../../src/lib/messageQueue.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,gBAAgB;IACnB,SAAS,GAAgD,EAAE,CAAC;IAC5D,MAAM,GAAqB,EAAE,CAAC;IAC9B,MAAM,GAAG,KAAK,CAAC;IAEvB,IAAI,CAAC,OAAe;QAClB,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,MAAM,GAAG,GAAmB;YAC1B,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;YAClC,kBAAkB,EAAE,IAAI;SACzB,CAAC;QACF,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACxC,IAAI,QAAQ;YAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;;YACvB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS;YAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;QAC3B,OAAO,IAAI,EAAE,CAAC;YACZ,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3B,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAG,CAAC;gBAC3B,SAAS;YACX,CAAC;YACD,IAAI,IAAI,CAAC,MAAM;gBAAE,OAAO;YACxB,MAAM,IAAI,GAAG,MAAM,IAAI,OAAO,CAAwB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACnF,IAAI,IAAI,KAAK,IAAI;gBAAE,OAAO;YAC1B,MAAM,IAAI,CAAC;QACb,CAAC;IACH,CAAC;CACF"}

package/dist/lib/paths.d.ts

@@ -0,0 +1,10 @@
+export declare function packageRoot(): string;
+export declare function packageSkillsDir(): string;
+export declare function userDir(): string;
+export declare function userConfigPath(): string;
+export declare function userMcpConfigPath(): string;
+export declare function sessionsDir(): string;
+export declare function sessionPath(name: string): string;
+export declare function projectConfigPath(cwd?: string): string;
+export declare function projectSkillsDir(cwd?: string): string;
+export declare function ensureDir(path: string): void;

package/dist/lib/paths.js

@@ -0,0 +1,38 @@
+import { homedir } from 'node:os';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { existsSync, mkdirSync } from 'node:fs';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+export function packageRoot() {
+    return join(__dirname, '..', '..');
+}
+export function packageSkillsDir() {
+    return join(packageRoot(), 'skills');
+}
+export function userDir() {
+    return join(homedir(), '.document360-writer');
+}
+export function userConfigPath() {
+    return join(userDir(), 'config.json');
+}
+export function userMcpConfigPath() {
+    return join(userDir(), 'mcp.json');
+}
+export function sessionsDir() {
+    return join(userDir(), 'sessions');
+}
+export function sessionPath(name) {
+    return join(sessionsDir(), `${name}.jsonl`);
+}
+export function projectConfigPath(cwd = process.cwd()) {
+    return join(cwd, '.d360-writer.json');
+}
+export function projectSkillsDir(cwd = process.cwd()) {
+    return join(cwd, '.d360-writer', 'skills');
+}
+export function ensureDir(path) {
+    if (!existsSync(path))
+        mkdirSync(path, { recursive: true });
+}
+//# sourceMappingURL=paths.js.map

package/dist/lib/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/lib/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEhD,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,MAAM,UAAU,WAAW;IACzB,OAAO,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,qBAAqB,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,aAAa,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,GAAG,IAAI,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IAC3D,OAAO,IAAI,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IAC1D,OAAO,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC9D,CAAC"}

package/dist/repl.d.ts

@@ -0,0 +1,5 @@
+export type ReplContext = {
+    cwd: string;
+    restartAgent: () => void;
+};
+export declare function runRepl(cwd?: string): Promise<void>;

package/dist/repl.js

@@ -0,0 +1,132 @@
+import { createInterface } from 'node:readline/promises';
+import { startAgent } from './agent.js';
+import { slashCommands, parseSlash } from './commands/index.js';
+import { accent, banner, dim, error, muted } from './lib/colors.js';
+export async function runRepl(cwd = process.cwd()) {
+    if (!process.env.ANTHROPIC_API_KEY) {
+        console.error('');
+        console.error(error('ANTHROPIC_API_KEY is not set.'));
+        console.error('');
+        console.error('Set it before running document360-writer:');
+        console.error('');
+        console.error(`  ${accent('export ANTHROPIC_API_KEY=sk-ant-...')}   (macOS / Linux)`);
+        console.error(`  ${accent('$env:ANTHROPIC_API_KEY="sk-ant-..."')}   (PowerShell)`);
+        console.error('');
+        console.error(`Get a key at ${accent('https://console.anthropic.com/settings/keys')}`);
+        console.error('');
+        process.exit(2);
+    }
+    printWelcome(cwd);
+    let session = startAgent(cwd);
+    const ctx = {
+        cwd,
+        restartAgent: () => {
+            session.queue.close();
+            session = startAgent(cwd);
+        },
+    };
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        while (true) {
+            const line = await rl.question(accent('> '));
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            if (trimmed.startsWith('/')) {
+                const parsed = parseSlash(trimmed);
+                if (!parsed)
+                    continue;
+                const cmd = slashCommands[parsed.name];
+                if (!cmd) {
+                    console.log(error(`Unknown command: /${parsed.name}`));
+                    console.log(dim('Type /help for the list.'));
+                    continue;
+                }
+                const result = await cmd(parsed.args, ctx);
+                if (result.kind === 'exit')
+                    break;
+                if (result.kind === 'clear') {
+                    ctx.restartAgent();
+                    continue;
+                }
+                if (result.kind === 'forward-to-agent') {
+                    session.queue.push(result.prompt);
+                    await consumeUntilResult(session.iterator);
+                }
+                continue;
+            }
+            session.queue.push(trimmed);
+            await consumeUntilResult(session.iterator);
+        }
+    }
+    finally {
+        session.queue.close();
+        rl.close();
+    }
+}
+function printWelcome(cwd) {
+    console.log('');
+    console.log(banner('document360-writer'));
+    console.log(dim(`  cwd: ${cwd}`));
+    console.log(dim('  Type a prompt, or /help for slash commands. /exit to quit.'));
+    console.log('');
+}
+async function consumeUntilResult(iterator) {
+    while (true) {
+        let next;
+        try {
+            next = await iterator.next();
+        }
+        catch (err) {
+            console.error('');
+            console.error(error(`agent error: ${err.message}`));
+            return;
+        }
+        if (next.done)
+            return;
+        const stop = renderMessage(next.value);
+        if (stop)
+            return;
+    }
+}
+function renderMessage(raw) {
+    if (!raw || typeof raw !== 'object')
+        return false;
+    const msg = raw;
+    if (msg.type === 'partial_assistant') {
+        const event = msg.event;
+        if (event?.delta && typeof event.delta.text === 'string') {
+            process.stdout.write(event.delta.text);
+        }
+        return false;
+    }
+    if (msg.type === 'assistant') {
+        const message = msg.message;
+        const blocks = message?.content ?? [];
+        let printedNewline = false;
+        for (const block of blocks) {
+            const b = block;
+            if (b.type === 'tool_use') {
+                if (!printedNewline) {
+                    process.stdout.write('\n');
+                    printedNewline = true;
+                }
+                console.log(muted(`  ⚙ ${b.name ?? 'tool'}`));
+            }
+        }
+        return false;
+    }
+    if (msg.type === 'result') {
+        const result = msg;
+        process.stdout.write('\n');
+        if (result.usage) {
+            const inT = result.usage.input_tokens ?? 0;
+            const outT = result.usage.output_tokens ?? 0;
+            console.log(dim(`  (${inT}→${outT} tokens)`));
+        }
+        console.log('');
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=repl.js.map

package/dist/repl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl.js","sourceRoot":"","sources":["../src/repl.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "document360-writer",
+  "version": "0.1.0",
+  "description": "Standalone documentation agent CLI. Reads your code, writes your docs. Specialized for Document360 publishing.",
+  "type": "module",
+  "bin": {
+    "document360-writer": "./dist/cli.js",
+    "d360-writer": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "skills",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/saravana-mv/document360-writer.git",
+    "directory": "packages/writer"
+  },
+  "homepage": "https://github.com/saravana-mv/document360-writer#readme",
+  "bugs": {
+    "url": "https://github.com/saravana-mv/document360-writer/issues"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.3.150",
+    "@inquirer/prompts": "^8.4.3",
+    "commander": "^14.0.3",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "rimraf": "^6.0.1",
+    "typescript": "~5.6.0"
+  },
+  "keywords": [
+    "documentation",
+    "agent",
+    "cli",
+    "document360",
+    "anthropic",
+    "claude",
+    "mcp"
+  ],
+  "license": "MIT"
+}

package/skills/CLAUDE.md

@@ -0,0 +1,92 @@
+# document360-writer — system prompt
+
+You are a documentation engineer working from inside the user's source repository. You read code, you write user-facing technical documentation, and you publish to Document360. You are precise, terse, and you never fabricate.
+
+## What you own
+
+- Reading the codebase to ground every claim in source.
+- Proposing documentation structure when one doesn't exist.
+- Authoring articles in markdown with the structure the user has standardized on.
+- Emitting screenshot placeholders that downstream tools (`document360-capture`) can act on.
+- Dual-publishing to Document360 via MCP when the user asks.
+
+## What you do NOT own
+
+- `git commit` / `git push` — the user handles version control.
+- Taking screenshots — you write placeholder instructions an intern (or a paired CLI) can act on.
+- Publishing past the draft stage — every D360 write is a draft; the human reviews and publishes manually in the portal.
+
+## Voice and style
+
+- Second person ("you"). Imperative ("Click Save", not "The user should click Save").
+- No marketing language. Banned: "simply", "just", "easily", "powerful", "seamless", "robust", "with one click", "right out of the box".
+- Be specific. If a button is labelled "+ Add", write "+ Add" — not "the add button".
+- Short paragraphs. Sentences average 15 words.
+
+## Article structure
+
+Every article follows this skeleton verbatim unless the user has overridden it in their project config:
+
+```
+# <Article title>
+
+<one-paragraph intro: what this article is for, who it's for, when to use it>
+
+## Prerequisites
+- <required role / permissions>
+- <required state / setup>
+
+## Steps
+1. <action>
+2. <action>
+3. ...
+
+## Tips & notes
+- <gotcha or pro tip>
+
+## Related articles
+- [<title>](<relative-path>.md)
+```
+
+## Markdown rules
+
+- Markdown only. Document360's API expects `contentType=0`.
+- One H1 per article. Use `##` for sections, `###` for subsections.
+- Code fences with language tag where applicable (`bash`, `json`, `tsx`, ...).
+- Tables for structured comparison; bullet lists otherwise.
+
+## Document360 publish form
+
+When publishing (only when explicitly asked, via `publish-to-d360` skill), transform the markdown:
+
+- Strip the H1 line. Document360 stores the title separately and renders it itself.
+- Strip every `<!-- SCREENSHOT ... -->` HTML comment block. Keep the visible `[Screenshot: ...]` line.
+- Convert relative cross-article links (e.g. `[Foo](../03-foo.md)`) to plain-text references like `See "Foo" → "Intro"`. Document360 handles cross-linking differently.
+- Everything else passes through verbatim.
+
+## Terminology
+
+The user's `.d360-writer.json` includes a `terminologyGlossary` map. Treat its keys/values as authoritative. Never substitute synonyms — if the glossary says "say 'flow' not 'workflow'", that's a hard rule.
+
+## Sourcing rule (never fabricate)
+
+Before writing any article that describes UI strings, button labels, routes, or behavior:
+
+1. Read the source files listed in `.d360-writer.json` `authoritativeSourceFiles`.
+2. Quote what the code actually does. If you can't find it, say so and ask the user.
+3. Never invent button labels, file paths, or behaviors that you didn't read.
+
+If a feature is role-gated, state the required role in **Prerequisites** — not buried in Steps.
+
+## Skill activation
+
+The "Capabilities" section below lists specialized skills. Pick the right one based on the user's request:
+
+- "analyze this repo" / "what should the docs look like" → `analyze-codebase`, then `propose-structure`.
+- "write the install guide" / "document feature X" → `write-article`.
+- "/audit" / "what's stale" → `audit-docs`.
+- "/publish ..." → `publish-to-d360`.
+- "/screenshot ..." or any time you generate a screenshot placeholder → also call `emit-screenshot-spec`.
+- Pulling extra context from other MCP sources during write-article → `gather-context-from-mcp`.
+
+If the user's intent is ambiguous, ask before invoking a skill that writes files or publishes.

package/skills/analyze-codebase/SKILL.md

@@ -0,0 +1,35 @@
+# Skill: analyze-codebase
+
+**Activate when** the user asks to "analyze the repo", "look around", "what should the docs cover", or any open-ended discovery question.
+
+**Goal:** produce a grounded report of what's in the repo, suitable for proposing a documentation structure.
+
+## What to read
+
+1. `README.md` (or any root-level readme variant).
+2. The package manifest: `package.json`, `pyproject.toml`, `Cargo.toml`, `go.mod`, etc.
+3. `CLAUDE.md` and `ARCHITECTURE.md` if present.
+4. The top-level layout: `src/`, `app/`, `lib/`, `cmd/`, `pkg/`, etc. — list directories, don't read every file.
+5. The last 50 commit messages (`git log --oneline -50`) to see the cadence and recent changes.
+6. Any directory named `docs/`, `user-docs/`, `documentation/`, or `wiki/` if present.
+
+## What to produce
+
+A short report with these sections, in this order:
+
+1. **Product surface** — what does this software do, from the perspective of the end user (not the developer)?
+2. **User segments** — who uses it? Roles, personas if you can identify them.
+3. **Major features** — list as many as you can find evidence for. Quote the source for each (file path or commit hash).
+4. **Existing documentation** — if any. What's there, what's stale, what's missing.
+5. **Recommended next step** — usually "propose-structure". If docs already exist, "audit-docs".
+
+## Rules
+
+- Do not propose a docs structure yet. That's a separate skill.
+- Do not write any articles in this phase.
+- Cite file paths for every claim. "FlowForge has a Spec Manager (src/pages/SpecFilesPage.tsx)" — not "FlowForge has spec management".
+- Keep the report under 600 words. Brevity matters; the user is going to read this.
+
+## When you can't find something
+
+If the repo is small or undocumented and you genuinely cannot tell what it does, say so. Ask the user one targeted question that would unblock you. Do not guess.