@nac3/forge-cli 0.2.0-alpha.1

package/dist/chat/spec_scaffold.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Spec scaffold executor (V1.42 + V1.43 of HITO 1).
+ *
+ * Takes a SpecPlan and writes the listed files into the
+ * projectRoot. Strict safety rules:
+ *
+ *   - Every target path is resolved against projectRoot and
+ *     the resolved absolute path is verified to still start
+ *     with projectRoot+separator. Symlinks, "..", absolute
+ *     paths all fail loudly.
+ *
+ *   - Existing files are NEVER overwritten by default. The
+ *     caller can pass force=true to allow overwrites, in
+ *     which case the original content is captured in the
+ *     RollbackEntry for V1.45.
+ *
+ *   - Each file write is tracked in a RollbackEntry so V1.45
+ *     can undo on partial failure or explicit user request.
+ *
+ *   - The scaffolder picks a template body for each file kind
+ *     + language so the output is immediately useful (real
+ *     ts module structure, not just empty files). Templates
+ *     are hand-rolled, no external library.
+ *
+ * ASCII-only.
+ */
+import type { SpecPlan } from './spec_plan.js';
+export interface ScaffoldOptions {
+    plan: SpecPlan;
+    projectRoot: string;
+    /** When true, existing files are overwritten + the original
+     *  content captured in the rollback log. Default false: the
+     *  scaffolder skips existing files and lists them as
+     *  'skipped' in the report. */
+    force?: boolean;
+    /** Per-file callback fired before each write. Useful for
+     *  progress streaming in V1.44; default is a noop. */
+    onProgress?: (event: ProgressEvent) => void;
+}
+export type ProgressEvent = {
+    kind: 'start';
+    total: number;
+} | {
+    kind: 'file_begin';
+    index: number;
+    path: string;
+} | {
+    kind: 'file_done';
+    index: number;
+    path: string;
+    action: 'created' | 'overwritten' | 'skipped';
+} | {
+    kind: 'file_error';
+    index: number;
+    path: string;
+    error: string;
+} | {
+    kind: 'done';
+    created: number;
+    skipped: number;
+    errors: number;
+};
+export interface RollbackEntry {
+    /** Absolute path of the file the scaffolder touched. */
+    abs_path: string;
+    /** What state we should restore to undo. */
+    action: 'delete' | 'restore';
+    /** Original file content when action='restore'. */
+    original?: Buffer;
+    /** Directories the scaffolder created that didn't exist
+     *  before. Removed if empty during rollback (V1.45). */
+    created_dirs?: string[];
+}
+export interface ScaffoldReport {
+    created: string[];
+    overwritten: string[];
+    skipped: string[];
+    errors: {
+        path: string;
+        error: string;
+    }[];
+    rollback_log: RollbackEntry[];
+}
+export declare function executeScaffold(opts: ScaffoldOptions): Promise<ScaffoldReport>;
+/** V1.45 -- undo a scaffold. Walks the rollback_log in
+ *  REVERSE order so newly created files are deleted before
+ *  their parent directories. */
+export declare function rollbackScaffold(log: RollbackEntry[]): Promise<{
+    undone: string[];
+    errors: {
+        path: string;
+        error: string;
+    }[];
+}>;
+//# sourceMappingURL=spec_scaffold.d.ts.map

package/dist/chat/spec_scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec_scaffold.d.ts","sourceRoot":"","sources":["../../src/chat/spec_scaffold.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAe,MAAM,gBAAgB,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB;;;mCAG+B;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;0DACsD;IACtD,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;CAC7C;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,SAAS,CAAA;CAAE,GACjG;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAClE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvE,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC7B,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;4DACwD;IACxD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,YAAY,EAAE,aAAa,EAAE,CAAC;CAC/B;AA8ED,wBAAsB,eAAe,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAiFpF;AAED;;gCAEgC;AAChC,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CAAC,CA8BrI"}

package/dist/chat/spec_scaffold.js

@@ -0,0 +1,220 @@
+/**
+ * Spec scaffold executor (V1.42 + V1.43 of HITO 1).
+ *
+ * Takes a SpecPlan and writes the listed files into the
+ * projectRoot. Strict safety rules:
+ *
+ *   - Every target path is resolved against projectRoot and
+ *     the resolved absolute path is verified to still start
+ *     with projectRoot+separator. Symlinks, "..", absolute
+ *     paths all fail loudly.
+ *
+ *   - Existing files are NEVER overwritten by default. The
+ *     caller can pass force=true to allow overwrites, in
+ *     which case the original content is captured in the
+ *     RollbackEntry for V1.45.
+ *
+ *   - Each file write is tracked in a RollbackEntry so V1.45
+ *     can undo on partial failure or explicit user request.
+ *
+ *   - The scaffolder picks a template body for each file kind
+ *     + language so the output is immediately useful (real
+ *     ts module structure, not just empty files). Templates
+ *     are hand-rolled, no external library.
+ *
+ * ASCII-only.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+function isWithinRoot(abs, root) {
+    const normRoot = path.resolve(root);
+    const normAbs = path.resolve(abs);
+    /* Trailing separator on root prevents the
+       "/project/legit-but-evil" false-positive prefix match. */
+    return normAbs === normRoot || normAbs.startsWith(normRoot + path.sep);
+}
+/** Compute the chain of parent directories of `abs` that do
+ *  NOT exist yet. Returns paths in creation order (root to
+ *  leaf). Used so rollback knows which directories the
+ *  scaffolder itself made and is allowed to remove. */
+async function dirsToCreate(abs) {
+    const out = [];
+    let cur = path.dirname(abs);
+    /* eslint-disable-next-line no-constant-condition */
+    while (true) {
+        try {
+            await fs.access(cur);
+            break;
+        }
+        catch {
+            out.unshift(cur);
+            const parent = path.dirname(cur);
+            if (parent === cur)
+                break;
+            cur = parent;
+        }
+    }
+    return out;
+}
+/* ----- templates ----- */
+function templateFor(file) {
+    const banner = '/* ' + (file.rationale || file.path) + ' */\n\n';
+    if (file.language === 'ts' || file.language === 'js') {
+        if (file.kind === 'model')
+            return banner
+                + '/* TODO: define the entity fields the spec lists. */\n'
+                + 'export interface Model {\n  id: string;\n}\n';
+        if (file.kind === 'api')
+            return banner
+                + '/* TODO: implement the endpoints the spec lists. */\n'
+                + 'export async function list(): Promise<unknown[]> {\n'
+                + '  return [];\n'
+                + '}\n';
+        return banner + 'export {};\n';
+    }
+    if (file.language === 'tsx' || file.language === 'jsx') {
+        return banner
+            + 'import React from \'react\';\n\n'
+            + 'export interface ' + safeIdent(file.path) + 'Props {\n  /* TODO: from spec */\n}\n\n'
+            + 'export function ' + safeIdent(file.path) + '(_props: ' + safeIdent(file.path) + 'Props) {\n'
+            + '  return <div>/* TODO */</div>;\n'
+            + '}\n';
+    }
+    if (file.language === 'md') {
+        return '# ' + (path.basename(file.path, '.md')) + '\n\n'
+            + (file.rationale || '') + '\n';
+    }
+    if (file.language === 'json') {
+        return '{\n  "TODO": "from spec"\n}\n';
+    }
+    if (file.language === 'css') {
+        return '/* ' + (file.rationale || file.path) + ' */\n';
+    }
+    return '/* ' + (file.rationale || file.path) + ' */\n';
+}
+/** Convert a path like "src/components/PatientCard.tsx" to
+ *  a safe identifier "PatientCard" for TSX templates. */
+function safeIdent(p) {
+    const base = path.basename(p).replace(/\.[^.]+$/, '');
+    const cleaned = base.replace(/[^a-zA-Z0-9_]/g, '_').replace(/^[0-9]/, '_$&');
+    return cleaned || 'Component';
+}
+/* ----- main ----- */
+export async function executeScaffold(opts) {
+    const report = {
+        created: [],
+        overwritten: [],
+        skipped: [],
+        errors: [],
+        rollback_log: [],
+    };
+    const total = opts.plan.files.length;
+    const onProgress = opts.onProgress ?? (() => undefined);
+    onProgress({ kind: 'start', total });
+    for (let i = 0; i < opts.plan.files.length; i += 1) {
+        const file = opts.plan.files[i];
+        const rel = file.path;
+        const abs = path.resolve(opts.projectRoot, rel);
+        onProgress({ kind: 'file_begin', index: i, path: rel });
+        if (!isWithinRoot(abs, opts.projectRoot)) {
+            const msg = 'path escapes projectRoot after resolution';
+            report.errors.push({ path: rel, error: msg });
+            onProgress({ kind: 'file_error', index: i, path: rel, error: msg });
+            continue;
+        }
+        let existsAlready = false;
+        let existingContent;
+        try {
+            existingContent = await fs.readFile(abs);
+            existsAlready = true;
+        }
+        catch (err) {
+            const e = err;
+            if (e.code !== 'ENOENT') {
+                const msg = 'cannot read existing file: ' + e.message;
+                report.errors.push({ path: rel, error: msg });
+                onProgress({ kind: 'file_error', index: i, path: rel, error: msg });
+                continue;
+            }
+        }
+        if (existsAlready && !opts.force) {
+            report.skipped.push(rel);
+            onProgress({ kind: 'file_done', index: i, path: rel, action: 'skipped' });
+            continue;
+        }
+        /* Compute which parent dirs we will need to create so
+           rollback knows to remove them. */
+        const newDirs = await dirsToCreate(abs);
+        try {
+            if (newDirs.length > 0) {
+                await fs.mkdir(path.dirname(abs), { recursive: true });
+            }
+            const content = templateFor(file);
+            await fs.writeFile(abs, content, 'utf-8');
+            const entry = existsAlready
+                ? { abs_path: abs, action: 'restore', original: existingContent }
+                : { abs_path: abs, action: 'delete' };
+            if (newDirs.length > 0)
+                entry.created_dirs = newDirs;
+            report.rollback_log.push(entry);
+            if (existsAlready) {
+                report.overwritten.push(rel);
+                onProgress({ kind: 'file_done', index: i, path: rel, action: 'overwritten' });
+            }
+            else {
+                report.created.push(rel);
+                onProgress({ kind: 'file_done', index: i, path: rel, action: 'created' });
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            report.errors.push({ path: rel, error: msg });
+            onProgress({ kind: 'file_error', index: i, path: rel, error: msg });
+        }
+    }
+    onProgress({
+        kind: 'done',
+        created: report.created.length + report.overwritten.length,
+        skipped: report.skipped.length,
+        errors: report.errors.length,
+    });
+    return report;
+}
+/** V1.45 -- undo a scaffold. Walks the rollback_log in
+ *  REVERSE order so newly created files are deleted before
+ *  their parent directories. */
+export async function rollbackScaffold(log) {
+    const undone = [];
+    const errors = [];
+    for (let i = log.length - 1; i >= 0; i -= 1) {
+        const entry = log[i];
+        try {
+            if (entry.action === 'delete') {
+                await fs.unlink(entry.abs_path);
+            }
+            else if (entry.action === 'restore' && entry.original) {
+                await fs.writeFile(entry.abs_path, entry.original);
+            }
+            undone.push(entry.abs_path);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            errors.push({ path: entry.abs_path, error: msg });
+            continue;
+        }
+        /* Try to remove directories the scaffolder created -- only
+           if empty. Walks from leaf to root. */
+        if (entry.created_dirs) {
+            for (let j = entry.created_dirs.length - 1; j >= 0; j -= 1) {
+                try {
+                    await fs.rmdir(entry.created_dirs[j]);
+                }
+                catch {
+                    /* Directory not empty or already gone -- harmless. */
+                }
+            }
+        }
+    }
+    return { undone, errors };
+}
+//# sourceMappingURL=spec_scaffold.js.map

package/dist/chat/spec_scaffold.js.map

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

package/dist/chat/tools/git.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Local git tools wired into the chat catalog (V1.12 of HITO 1).
+ *
+ * Four tools land in this slice:
+ *   - forge.git_commit(repo_dir?, message, all?)
+ *   - forge.git_push(repo_dir?, remote?, branch?, force?)
+ *   - forge.git_pull(repo_dir?, remote?, branch?)
+ *   - forge.git_log(repo_dir?, max?)
+ *
+ * push --force is gated by ROADMAP sec 2.4 Layer 3 (the
+ * dispatcher MUST run V1.10 liveness before invoking it).
+ * commit + plain push + pull are write-class (requires_approval
+ * true). log is read-only.
+ *
+ * All exec via the same DI-injectable runner pattern as github.ts.
+ *
+ * ASCII-only.
+ */
+import { Vault } from '../../vault/store.js';
+import type { ToolContext, ToolResult, ToolSpec } from '../tools.js';
+declare const VAULT_SLOT = "github_token";
+export type ExecImpl = (cmd: string, args: string[], opts?: {
+    cwd?: string;
+    env?: Record<string, string | undefined>;
+}) => Promise<{
+    code: number;
+    stdout: string;
+    stderr: string;
+}>;
+export interface GitDeps {
+    vaultOpener?: () => Promise<Vault>;
+    execImpl?: ExecImpl;
+}
+export declare const GIT_COMMIT_SPEC: ToolSpec;
+export declare const GIT_PUSH_SPEC: ToolSpec;
+export declare const GIT_PULL_SPEC: ToolSpec;
+export declare const GIT_LOG_SPEC: ToolSpec;
+export declare function runGitCommit(args: {
+    repo_dir?: string;
+    message: string;
+    all?: boolean;
+}, ctx: ToolContext, deps?: GitDeps): Promise<ToolResult>;
+export declare function runGitPush(args: {
+    repo_dir?: string;
+    remote?: string;
+    branch?: string;
+    force?: boolean;
+}, ctx: ToolContext, deps?: GitDeps): Promise<ToolResult>;
+export declare function runGitPull(args: {
+    repo_dir?: string;
+    remote?: string;
+    branch?: string;
+}, ctx: ToolContext, deps?: GitDeps): Promise<ToolResult>;
+export declare function runGitLog(args: {
+    repo_dir?: string;
+    max?: number;
+}, ctx: ToolContext, deps?: GitDeps): Promise<ToolResult>;
+export { VAULT_SLOT };
+//# sourceMappingURL=git.d.ts.map

package/dist/chat/tools/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../../src/chat/tools/git.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAI7C,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAErE,QAAA,MAAM,UAAU,iBAAiB,CAAC;AAIlC,MAAM,MAAM,QAAQ,GAAG,CACrB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;CAAE,KAC9D,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE/D,MAAM,WAAW,OAAO;IACtB,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AA2CD,eAAO,MAAM,eAAe,EAAE,QAa7B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,QAc3B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,QAa3B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,QAY1B,CAAC;AAMF,wBAAsB,YAAY,CAChC,IAAI,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,EAC3D,GAAG,EAAE,WAAW,EAChB,IAAI,GAAE,OAAY,GACjB,OAAO,CAAC,UAAU,CAAC,CAwCrB;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,EAC9E,GAAG,EAAE,WAAW,EAChB,IAAI,GAAE,OAAY,GACjB,OAAO,CAAC,UAAU,CAAC,CAuDrB;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7D,GAAG,EAAE,WAAW,EAChB,IAAI,GAAE,OAAY,GACjB,OAAO,CAAC,UAAU,CAAC,CA0CrB;AAED,wBAAsB,SAAS,CAC7B,IAAI,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,EACzC,GAAG,EAAE,WAAW,EAChB,IAAI,GAAE,OAAY,GACjB,OAAO,CAAC,UAAU,CAAC,CA6BrB;AASD,OAAO,EAAE,UAAU,EAAE,CAAC"}