azcodr 1.5.2 → 2.1.0

package/lib/cli-parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-parse.js","sourceRoot":"","sources":["../src/cli-parse.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,MAAM,UAAU,YAAY;IAC1B,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AACvF,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAyB;IAC3D,CAAC,IAAI,EAAE,OAAO,CAAC;IACf,CAAC,SAAS,EAAE,OAAO,CAAC;IACpB,CAAC,UAAU,EAAE,OAAO,CAAC;IACrB,CAAC,IAAI,EAAE,QAAQ,CAAC;IAChB,CAAC,WAAW,EAAE,QAAQ,CAAC;IACvB,CAAC,IAAI,EAAE,QAAQ,CAAC;IAChB,CAAC,UAAU,EAAE,QAAQ,CAAC;CACvB,CAAC,CAAC;AAOH,MAAM,UAAU,QAAQ,CACtB,KAAqD,EACrD,GAAW;IAEX,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,QAAQ;QAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAClE,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,WAAW;QAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACxE,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QACnB,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC5B,CAAC;IACD,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO;YACL,QAAQ,EAAE,cAAc;YACxB,OAAO,EAAE,qBAAqB,GAAG,mDAAmD;SACrF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QACrB,KAAK,CAAC,SAAS,GAAG,GAAG,CAAC;QACtB,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC5B,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,WAAW;QACrB,OAAO,EAAE,wBAAwB,GAAG,mDAAmD;KACxF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAA0B;IAClD,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;IAC7B,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACrC,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YAC9B,OAAO,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;QAC5E,CAAC;IACH,CAAC;IACD,OAAO,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAC1D,CAAC;AAED,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC"}

package/lib/cli-target.d.ts

@@ -0,0 +1,66 @@
+export interface AskQuestionOptions {
+    input?: NodeJS.ReadableStream;
+    output?: NodeJS.WritableStream;
+}
+export declare function askQuestion(query: string, { input, output }?: AskQuestionOptions): Promise<string>;
+export interface PromptIo {
+    stdin: NodeJS.ReadStream | (NodeJS.ReadableStream & {
+        isTTY?: boolean;
+    });
+    stdout: NodeJS.WriteStream | NodeJS.WritableStream;
+}
+export declare function promptForTargetDir(io: PromptIo): Promise<string>;
+export declare function rejectBadTarget(resolvedTarget: string, templateDir: string): string | null;
+export interface ResolveTargetIo extends PromptIo {
+    cwd: string;
+    templateDir: string;
+}
+export interface ResolveTargetResult {
+    resolvedTarget: string;
+    chosen: string;
+    error: string | null;
+}
+export declare function resolveTargetDir(targetDir: string | null, io: ResolveTargetIo): Promise<ResolveTargetResult>;
+export type TargetDirectoryStatus = 'missing' | 'not-a-directory' | 'empty' | 'non-empty';
+export interface TargetStatusResult {
+    status: TargetDirectoryStatus;
+    count: number;
+}
+export declare function targetStatus(resolvedTarget: string): TargetStatusResult;
+export interface ConfirmOverwriteIo extends PromptIo {
+    out: (msg: string) => void;
+}
+export interface ConfirmOverwriteResult {
+    confirmed: boolean;
+    aborted: boolean;
+}
+export declare function confirmOverwrite(targetDir: string, count: number, io: ConfirmOverwriteIo): Promise<ConfirmOverwriteResult>;
+export interface EnsureWritableOptions {
+    chosen: string;
+    resolvedTarget: string;
+    force: boolean;
+    io: ConfirmOverwriteIo & {
+        err: (msg: string) => void;
+    };
+}
+export interface EnsureWritableResult {
+    force?: boolean;
+    exitCode?: number;
+    message?: string | null;
+}
+/**
+ * Ensures the target may be written. Returns { force } on success or
+ * { exitCode, message? } when the CLI must stop before scaffolding.
+ */
+export declare function ensureWritableTarget(options: EnsureWritableOptions): Promise<EnsureWritableResult>;
+declare const _default: {
+    askQuestion: typeof askQuestion;
+    promptForTargetDir: typeof promptForTargetDir;
+    rejectBadTarget: typeof rejectBadTarget;
+    resolveTargetDir: typeof resolveTargetDir;
+    targetStatus: typeof targetStatus;
+    confirmOverwrite: typeof confirmOverwrite;
+    ensureWritableTarget: typeof ensureWritableTarget;
+};
+export default _default;
+//# sourceMappingURL=cli-target.d.ts.map

package/lib/cli-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-target.d.ts","sourceRoot":"","sources":["../src/cli-target.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;CAChC;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,EAAE,KAAqB,EAAE,MAAuB,EAAE,GAAE,kBAAuB,GAC1E,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC,UAAU,GAAG,CAAC,MAAM,CAAC,cAAc,GAAG;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACzE,MAAM,EAAE,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,cAAc,CAAC;CACpD;AAED,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAQtE;AAED,wBAAgB,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ1F;AAED,MAAM,WAAW,eAAgB,SAAQ,QAAQ;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,EAAE,EAAE,eAAe,GAClB,OAAO,CAAC,mBAAmB,CAAC,CAO9B;AAED,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,iBAAiB,GAAG,OAAO,GAAG,WAAW,CAAC;AAE1F,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,YAAY,CAAC,cAAc,EAAE,MAAM,GAAG,kBAAkB,CAKvE;AAED,MAAM,WAAW,kBAAmB,SAAQ,QAAQ;IAClD,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,kBAAkB,GACrB,OAAO,CAAC,sBAAsB,CAAC,CAYjC;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,EAAE,EAAE,kBAAkB,GAAG;QAAE,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC;CACzD;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAa/B;;;;;;;;;;AAED,wBAQE"}

package/lib/cli-target.js

@@ -0,0 +1,102 @@
+import path from 'node:path';
+import readline from 'node:readline';
+import fs from 'node:fs';
+import process from 'node:process';
+import { isProtectedTarget } from './guards.js';
+export function askQuestion(query, { input = process.stdin, output = process.stdout } = {}) {
+    const rl = readline.createInterface({ input, output });
+    return new Promise((resolve) => {
+        let resolved = false;
+        rl.question(query, (answer) => {
+            if (!resolved) {
+                resolved = true;
+                rl.close();
+                resolve(answer.trim());
+            }
+        });
+        rl.on('close', () => {
+            if (!resolved) {
+                resolved = true;
+                resolve('');
+            }
+        });
+    });
+}
+export async function promptForTargetDir(io) {
+    const { stdin, stdout } = io;
+    if (!stdin.isTTY)
+        return '.';
+    const answer = await askQuestion('? Where would you like to initialize your project? (./) ', {
+        input: stdin,
+        output: stdout
+    });
+    return answer || '.';
+}
+export function rejectBadTarget(resolvedTarget, templateDir) {
+    if (resolvedTarget === templateDir) {
+        return `Cannot scaffold into the template directory itself: ${resolvedTarget}`;
+    }
+    if (isProtectedTarget(resolvedTarget, { templateDir })) {
+        return `Refusing to scaffold into protected directory: ${resolvedTarget}. Choose a project subdirectory instead.`;
+    }
+    return null;
+}
+export async function resolveTargetDir(targetDir, io) {
+    const { cwd, templateDir } = io;
+    const chosen = targetDir || (await promptForTargetDir(io));
+    const resolvedTarget = path.resolve(cwd, chosen);
+    const rejection = rejectBadTarget(resolvedTarget, templateDir);
+    if (rejection !== null)
+        return { resolvedTarget, chosen, error: rejection };
+    return { resolvedTarget, chosen, error: null };
+}
+export function targetStatus(resolvedTarget) {
+    if (!fs.existsSync(resolvedTarget))
+        return { status: 'missing', count: 0 };
+    if (!fs.statSync(resolvedTarget).isDirectory())
+        return { status: 'not-a-directory', count: 0 };
+    const count = fs.readdirSync(resolvedTarget).length;
+    return { status: count === 0 ? 'empty' : 'non-empty', count };
+}
+export async function confirmOverwrite(targetDir, count, io) {
+    const { stdin, stdout, out } = io;
+    if (!stdin.isTTY)
+        return { confirmed: false, aborted: false };
+    const confirm = await askQuestion(`⚠️  Target directory '${targetDir}' is not empty (${count} items). Continue? (y/N) `, { input: stdin, output: stdout });
+    if (confirm.toLowerCase() !== 'y' && confirm.toLowerCase() !== 'yes') {
+        out('Scaffolding aborted.');
+        return { confirmed: false, aborted: true };
+    }
+    return { confirmed: true, aborted: false };
+}
+/**
+ * Ensures the target may be written. Returns { force } on success or
+ * { exitCode, message? } when the CLI must stop before scaffolding.
+ */
+export async function ensureWritableTarget(options) {
+    const { chosen, resolvedTarget, force, io } = options;
+    const { err } = io;
+    const { status, count } = targetStatus(resolvedTarget);
+    if (status === 'missing' || status === 'empty' || force)
+        return { force };
+    if (status === 'not-a-directory') {
+        return { exitCode: 1, message: `Target '${resolvedTarget}' already exists and is not a directory.` };
+    }
+    const { confirmed, aborted } = await confirmOverwrite(chosen, count, io);
+    if (aborted)
+        return { exitCode: 0, message: null };
+    if (confirmed)
+        return { force: true };
+    err(`Target directory '${resolvedTarget}' is not empty. Use --force to proceed.`);
+    return { exitCode: 1, message: null };
+}
+export default {
+    askQuestion,
+    promptForTargetDir,
+    rejectBadTarget,
+    resolveTargetDir,
+    targetStatus,
+    confirmOverwrite,
+    ensureWritableTarget
+};
+//# sourceMappingURL=cli-target.js.map

package/lib/cli-target.js.map

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

package/lib/cli.d.ts

@@ -0,0 +1,40 @@
+import type { ScaffoldOptions, ScaffoldResult } from './scaffold.js';
+import { askQuestion } from './cli-target.js';
+export declare function printHelp(out?: (msg: string) => void): void;
+export declare function printVersion(out?: (msg: string) => void): void;
+export interface CliIo {
+    out?: (msg: string) => void;
+    err?: (msg: string) => void;
+    exit?: (code: number) => void | number;
+    stdin?: NodeJS.ReadableStream & {
+        isTTY?: boolean;
+    };
+    stdout?: NodeJS.WritableStream;
+    cwd?: string;
+    templateDir?: string;
+    scaffold?: (options?: ScaffoldOptions) => ScaffoldResult;
+}
+export interface NormalizedCliIo {
+    out: (msg: string) => void;
+    err: (msg: string) => void;
+    exit: (code: number) => void | number;
+    stdin: NodeJS.ReadableStream & {
+        isTTY?: boolean;
+    };
+    stdout: NodeJS.WritableStream;
+    cwd: string;
+    templateDir: string;
+    scaffoldFn: (options?: ScaffoldOptions) => ScaffoldResult;
+}
+export declare function runCli(rawArgs?: string[], io?: CliIo): Promise<void | number>;
+export declare function main(): Promise<void>;
+export { askQuestion };
+declare const _default: {
+    runCli: typeof runCli;
+    main: typeof main;
+    printHelp: typeof printHelp;
+    printVersion: typeof printVersion;
+    askQuestion: typeof askQuestion;
+};
+export default _default;
+//# sourceMappingURL=cli.d.ts.map

package/lib/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGrE,OAAO,EAAE,WAAW,EAA0C,MAAM,iBAAiB,CAAC;AAatF,wBAAgB,SAAS,CAAC,GAAG,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAkB,GAAG,IAAI,CAwBxE;AAED,wBAAgB,YAAY,CAAC,GAAG,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAkB,GAAG,IAAI,CAE3E;AAED,MAAM,WAAW,KAAK;IACpB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,GAAG;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,eAAe,KAAK,cAAc,CAAC;CAC1D;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,CAAC;IACtC,KAAK,EAAE,MAAM,CAAC,cAAc,GAAG;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACnD,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,CAAC,OAAO,CAAC,EAAE,eAAe,KAAK,cAAc,CAAC;CAC3D;AA6HD,wBAAsB,MAAM,CAC1B,OAAO,GAAE,MAAM,EAA0B,EACzC,EAAE,GAAE,KAAU,GACb,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,CAqBxB;AAED,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAO1C;AAED,OAAO,EAAE,WAAW,EAAE,CAAC;;;;;;;;AAEvB,wBAME"}

package/lib/cli.js

@@ -0,0 +1,166 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import process from 'node:process';
+import { fileURLToPath } from 'node:url';
+import { scaffold, getTemplateDir } from './scaffold.js';
+import { parseArgs } from './cli-parse.js';
+import { askQuestion, resolveTargetDir, ensureWritableTarget } from './cli-target.js';
+const pkg = JSON.parse(fs.readFileSync(path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'package.json'), 'utf-8'));
+export function printHelp(out = console.log) {
+    out(`
+azcodr v${pkg.version}
+Enterprise Multi-Tenant Architecture & Agentic Engineering Starter Template
+
+Usage:
+  npx azcodr [directory] [options]
+
+Commands:
+  [directory]     Scaffold azcodr template into directory (default: current directory)
+
+Options:
+  -d, --dry-run   Simulate scaffolding without modifying filesystem
+  -s, --silent    Suppress console output messages
+  -f, --force     Overwrite existing files in target directory without confirmation
+  --no-git        Do not initialize a git repository
+  -v, --version   Display version number
+  -h, --help      Display this help message
+
+Examples:
+  npx azcodr my-project
+  npx azcodr . --dry-run
+  npx azcodr . --force
+`);
+}
+export function printVersion(out = console.log) {
+    out(pkg.version);
+}
+function normalizeIo(io = {}) {
+    const { out = console.log, err = console.error, exit = process.exit, stdin = process.stdin, stdout = process.stdout, cwd = process.cwd(), templateDir = getTemplateDir(), scaffold: scaffoldFn = scaffold } = io;
+    return { out, err, exit, stdin, stdout, cwd, templateDir, scaffoldFn };
+}
+function outBanner(fullIo) {
+    fullIo.out('\n🚀 azcodr - Enterprise Multi-Tenant Architecture & Agentic Engineering\n');
+}
+function handleTerminal(parsed, io) {
+    const { out, err, exit } = io;
+    if (parsed.terminal === 'help') {
+        printHelp(out);
+        return exit(0);
+    }
+    if (parsed.terminal === 'version') {
+        printVersion(out);
+        return exit(0);
+    }
+    err(`❌ Error: ${parsed.message}`);
+    return exit(1);
+}
+function reportDryRun(result, out) {
+    for (const action of result.actions) {
+        out(`  [preview] ${action}`);
+    }
+    out('\n🎉 Dry run completed. 0 files modified on disk.\n');
+}
+function reportSuccess(result, targetDir, out) {
+    out('  ✅ Progressive disclosure rules copied (docs/rules/)');
+    out('  ✅ Workspace knowledge hub and ADR ledger copied (docs/knowledge/, memory.md)');
+    out('  ✅ Specialized agentic skills copied (.agents/skills/)');
+    out('  ✅ Editor formatting standards initialized (.editorconfig)');
+    out('  ✅ Agent directives and harness symlinks established (AGENTS.md, CLAUDE.md, agents.md, GEMINI.md, .cursorrules, .windsurfrules, .github/copilot-instructions.md)');
+    out('  ✅ Project configuration initialized (package.json)');
+    if (result.gitInitialized) {
+        out('  ✅ Git repository initialized');
+    }
+    out('\n🎉 azcodr initialized successfully!\n');
+    out('Next steps:');
+    let step = 1;
+    if (targetDir !== '.' && targetDir !== './') {
+        out(`  ${step++}. cd ${targetDir}`);
+    }
+    out(`  ${step++}. Open the project in your AI coding assistant (Antigravity, Claude Code, Cursor, OpenHands)`);
+    out(`  ${step++}. Run /lets-build to start the architectural interview and scaffold your application stack!\n`);
+}
+function runScaffold(resolvedTarget, parsed, io) {
+    const { out, err, exit, templateDir, scaffoldFn } = io;
+    const banner = parsed.dryRun
+        ? `🔍 DRY RUN: Simulating azcodr scaffolding into: ${resolvedTarget}\n`
+        : `📦 Scaffolding azcodr into: ${resolvedTarget}`;
+    if (!parsed.silent)
+        out(banner);
+    try {
+        const result = scaffoldFn({
+            targetDir: resolvedTarget,
+            force: parsed.force,
+            noGit: parsed.noGit,
+            templateDir,
+            dryRun: parsed.dryRun,
+            silent: parsed.silent
+        });
+        if (!parsed.silent) {
+            if (parsed.dryRun)
+                reportDryRun(result, out);
+            else
+                reportSuccess(result, parsed.targetDir, out);
+        }
+        return exit(0);
+    }
+    catch (error) {
+        err(`\n❌ Scaffolding failed: ${error.message}\n`);
+        return exit(1);
+    }
+}
+async function resolvePhase(parsed, fullIo) {
+    const { resolvedTarget, chosen, error } = await resolveTargetDir(parsed.targetDir, fullIo);
+    if (error !== null) {
+        fullIo.err(`❌ Error: ${error}`);
+        return { exitCode: 1 };
+    }
+    return { resolvedTarget, chosen };
+}
+async function writablePhase(target, force, fullIo) {
+    const writable = await ensureWritableTarget({
+        chosen: target.chosen,
+        resolvedTarget: target.resolvedTarget,
+        force,
+        io: fullIo
+    });
+    if (writable.exitCode === undefined)
+        return { force: writable.force };
+    if (writable.message) {
+        fullIo.err(`❌ Error: ${writable.message}`);
+    }
+    return { exitCode: writable.exitCode };
+}
+export async function runCli(rawArgs = process.argv.slice(2), io = {}) {
+    const fullIo = normalizeIo(io);
+    const parsed = parseArgs(rawArgs);
+    if (parsed.terminal !== null)
+        return handleTerminal(parsed, fullIo);
+    if (!parsed.silent) {
+        outBanner(fullIo);
+    }
+    const target = await resolvePhase(parsed, fullIo);
+    if (target.exitCode !== undefined)
+        return fullIo.exit(target.exitCode);
+    const ready = await writablePhase(target, parsed.force, fullIo);
+    if (ready.exitCode !== undefined)
+        return fullIo.exit(ready.exitCode);
+    return runScaffold(target.resolvedTarget, { ...parsed, force: ready.force }, fullIo);
+}
+export async function main() {
+    try {
+        await runCli(process.argv.slice(2));
+    }
+    catch (err) {
+        console.error('Unexpected error:', err);
+        process.exit(1);
+    }
+}
+export { askQuestion };
+export default {
+    runCli,
+    main,
+    printHelp,
+    printVersion,
+    askQuestion
+};
+//# sourceMappingURL=cli.js.map

package/lib/cli.js.map

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

package/lib/errors.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Machine-readable failure codes.
+ *
+ * Consumers branch on `err.code`, never on message text: a wording change must
+ * never be a breaking change (learned from typed-settings, where `docs/errors.md`
+ * explicitly tells users not to regex the message). Pinned by
+ * tests/error-codes.test.js.
+ */
+export declare const ERROR_CODES: {
+    readonly E_TARGET_IS_TEMPLATE: "Cannot scaffold into the azcodr template directory itself";
+    readonly E_TARGET_NOT_EMPTY: "Target directory is not empty";
+    readonly E_TARGET_IS_PROTECTED: "Refusing to scaffold into a protected system directory";
+    readonly E_GIT_ARGS_INVALID: "runGit requires a non-empty argv array";
+    readonly E_GIT_BLOCKED: "Blocked git subcommand";
+    readonly E_PATH_ESCAPE: "Path escapes allowed root";
+};
+export type ScaffoldErrorCode = keyof typeof ERROR_CODES;
+export interface ScaffoldErrorShape extends Error {
+    name: 'ScaffoldError';
+    code: ScaffoldErrorCode;
+}
+export declare class ScaffoldError extends Error implements ScaffoldErrorShape {
+    readonly name: 'ScaffoldError';
+    readonly code: ScaffoldErrorCode;
+    constructor(code: ScaffoldErrorCode, message: string);
+}
+declare const _default: {
+    ERROR_CODES: {
+        readonly E_TARGET_IS_TEMPLATE: "Cannot scaffold into the azcodr template directory itself";
+        readonly E_TARGET_NOT_EMPTY: "Target directory is not empty";
+        readonly E_TARGET_IS_PROTECTED: "Refusing to scaffold into a protected system directory";
+        readonly E_GIT_ARGS_INVALID: "runGit requires a non-empty argv array";
+        readonly E_GIT_BLOCKED: "Blocked git subcommand";
+        readonly E_PATH_ESCAPE: "Path escapes allowed root";
+    };
+    ScaffoldError: typeof ScaffoldError;
+};
+export default _default;
+//# sourceMappingURL=errors.d.ts.map

package/lib/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW;;;;;;;CAOd,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,WAAW,CAAC;AAEzD,MAAM,WAAW,kBAAmB,SAAQ,KAAK;IAC/C,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAED,qBAAa,aAAc,SAAQ,KAAM,YAAW,kBAAkB;IACpE,SAAkB,IAAI,EAAE,eAAe,CAAmB;IAC1D,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;gBAErB,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM;CAIrD;;;;;;;;;;;;AAED,wBAA8C"}

package/lib/errors.js

@@ -0,0 +1,26 @@
+/**
+ * Machine-readable failure codes.
+ *
+ * Consumers branch on `err.code`, never on message text: a wording change must
+ * never be a breaking change (learned from typed-settings, where `docs/errors.md`
+ * explicitly tells users not to regex the message). Pinned by
+ * tests/error-codes.test.js.
+ */
+export const ERROR_CODES = {
+    E_TARGET_IS_TEMPLATE: 'Cannot scaffold into the azcodr template directory itself',
+    E_TARGET_NOT_EMPTY: 'Target directory is not empty',
+    E_TARGET_IS_PROTECTED: 'Refusing to scaffold into a protected system directory',
+    E_GIT_ARGS_INVALID: 'runGit requires a non-empty argv array',
+    E_GIT_BLOCKED: 'Blocked git subcommand',
+    E_PATH_ESCAPE: 'Path escapes allowed root'
+};
+export class ScaffoldError extends Error {
+    name = 'ScaffoldError';
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+    }
+}
+export default { ERROR_CODES, ScaffoldError };
+//# sourceMappingURL=errors.js.map

package/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,oBAAoB,EAAE,2DAA2D;IACjF,kBAAkB,EAAE,+BAA+B;IACnD,qBAAqB,EAAE,wDAAwD;IAC/E,kBAAkB,EAAE,wCAAwC;IAC5D,aAAa,EAAE,wBAAwB;IACvC,aAAa,EAAE,2BAA2B;CAClC,CAAC;AASX,MAAM,OAAO,aAAc,SAAQ,KAAK;IACpB,IAAI,GAAoB,eAAe,CAAC;IACjD,IAAI,CAAoB;IAEjC,YAAY,IAAuB,EAAE,OAAe;QAClD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC"}

package/lib/git.d.ts

@@ -0,0 +1,15 @@
+import cp from 'node:child_process';
+/**
+ * Socket-hardened process boundary (Supply Chain: shell access).
+ * Scaffolder must spawn `git`, but never via a shell string.
+ * Uses execFileSync with argv (shell:false) and an explicit subcommand allowlist.
+ * No network, no env exfiltration; cwd is constrained to targetDir callers.
+ */
+export declare const GIT_ALLOWED_SUBCOMMANDS: Set<string>;
+export declare function runGit(args: string[], options?: cp.ExecFileSyncOptions): string;
+declare const _default: {
+    GIT_ALLOWED_SUBCOMMANDS: Set<string>;
+    runGit: typeof runGit;
+};
+export default _default;
+//# sourceMappingURL=git.d.ts.map

package/lib/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGpC;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,aAMlC,CAAC;AAEH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,EAAE,CAAC,mBAAwB,GAAG,MAAM,CAcnF;;;;;AAED,wBAAmD"}

package/lib/git.js

@@ -0,0 +1,32 @@
+import cp from 'node:child_process';
+import { ScaffoldError, ERROR_CODES } from './errors.js';
+/**
+ * Socket-hardened process boundary (Supply Chain: shell access).
+ * Scaffolder must spawn `git`, but never via a shell string.
+ * Uses execFileSync with argv (shell:false) and an explicit subcommand allowlist.
+ * No network, no env exfiltration; cwd is constrained to targetDir callers.
+ */
+export const GIT_ALLOWED_SUBCOMMANDS = new Set([
+    'rev-parse',
+    'init',
+    'branch',
+    'add',
+    'commit'
+]);
+export function runGit(args, options = {}) {
+    if (!Array.isArray(args) || args.length === 0) {
+        throw new ScaffoldError('E_GIT_ARGS_INVALID', ERROR_CODES.E_GIT_ARGS_INVALID);
+    }
+    const subcommand = args[0];
+    if (!subcommand || !GIT_ALLOWED_SUBCOMMANDS.has(subcommand)) {
+        throw new ScaffoldError('E_GIT_BLOCKED', `${ERROR_CODES.E_GIT_BLOCKED}: ${String(subcommand)}`);
+    }
+    return cp.execFileSync('git', args, {
+        encoding: 'utf-8',
+        stdio: 'pipe',
+        shell: false,
+        ...options
+    });
+}
+export default { GIT_ALLOWED_SUBCOMMANDS, runGit };
+//# sourceMappingURL=git.js.map

package/lib/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC;IAC7C,WAAW;IACX,MAAM;IACN,QAAQ;IACR,KAAK;IACL,QAAQ;CACT,CAAC,CAAC;AAEH,MAAM,UAAU,MAAM,CAAC,IAAc,EAAE,UAAkC,EAAE;IACzE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,aAAa,CAAC,oBAAoB,EAAE,WAAW,CAAC,kBAAkB,CAAC,CAAC;IAChF,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3B,IAAI,CAAC,UAAU,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,aAAa,CAAC,eAAe,EAAE,GAAG,WAAW,CAAC,aAAa,KAAK,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAClG,CAAC;IACD,OAAO,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE;QAClC,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,KAAK;QACZ,GAAG,OAAO;KACX,CAAW,CAAC;AACf,CAAC;AAED,eAAe,EAAE,uBAAuB,EAAE,MAAM,EAAE,CAAC"}

package/lib/guards.d.ts

@@ -0,0 +1,35 @@
+export interface ProtectedTargetOptions {
+    templateDir?: string;
+    force?: boolean;
+    dryRun?: boolean;
+    allowProtected?: boolean;
+}
+/**
+ * Filesystem scope guard (Supply Chain: filesystem access).
+ * Constrains all reads/writes to targetDir / templateDir.
+ */
+export declare function assertInside(root: string, candidate: string, message?: string): void;
+/**
+ * Normalizes a path for protected-target comparison. On Windows the filesystem
+ * is case-insensitive, so `C:\Users\Name` and `c:\users\name` are the same
+ * directory and must compare equal.
+ */
+export declare function normalizeForComparison(p: string): string;
+/**
+ * Returns true when `targetDir` is a location the scaffolder must never write
+ * into: the filesystem root, the user's home directory, the home directory's
+ * parent (e.g. /home, C:\Users -- scaffolding there affects every user), or an
+ * ancestor of the template itself (scaffolding into D:\projects would merge
+ * the template into its own parent).
+ *
+ * Lexical comparison is not enough: a symlink pointing at home must also be
+ * caught, so an existing target is resolved with realpath before comparing.
+ */
+export declare function isProtectedTarget(targetDir: string, options?: ProtectedTargetOptions): boolean;
+declare const _default: {
+    assertInside: typeof assertInside;
+    normalizeForComparison: typeof normalizeForComparison;
+    isProtectedTarget: typeof isProtectedTarget;
+};
+export default _default;
+//# sourceMappingURL=guards.d.ts.map

package/lib/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../src/guards.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAOpF;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAGxD;AAwCD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,OAAO,CASlG;;;;;;AAED,wBAIE"}