aspectcode 0.2.0

package/bin/aspectcode.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+'use strict';
+
+require('../dist/main.js').run();

package/dist/cli.d.ts

@@ -0,0 +1,102 @@
+/**
+ * aspectcode CLI — shared types, flag definitions, and interfaces.
+ */
+import type { EmitReport } from '@aspectcode/emitters';
+import type { AspectCodeConfig } from './config';
+import type { Logger } from './logger';
+export type FlagType = 'boolean' | 'string' | 'enum';
+export interface FlagDef {
+    /** Long flag name (without --). */
+    name: string;
+    /** Short alias (without -), e.g. 'r'. */
+    short?: string;
+    /** Flag value type. */
+    type: FlagType;
+    /** Allowed enum values (when type === 'enum'). */
+    values?: readonly string[];
+    /** Help-text description. */
+    description: string;
+    /** Which commands this flag applies to, or 'global'. */
+    appliesTo: 'global' | string[];
+    /** The property name on CliFlags (defaults to camelCase of `name`). */
+    prop?: keyof CliFlags;
+}
+/**
+ * Canonical list of every CLI flag. Adding a new flag is a single entry here
+ * — parseArgs() and printHelp() derive from this array automatically.
+ */
+export declare const FLAG_DEFS: readonly FlagDef[];
+/** Parsed CLI arguments. */
+export interface CliArgs {
+    command: string;
+    flags: CliFlags;
+    positionals: string[];
+}
+/** Named flags extracted from argv. */
+export interface CliFlags {
+    help: boolean;
+    version: boolean;
+    verbose: boolean;
+    quiet: boolean;
+    /** --root / -r : workspace root override (defaults to cwd). */
+    root?: string;
+    /** --out / -o : output directory override. */
+    out?: string;
+    /** --list-connections: print dependency connections in text form. */
+    listConnections: boolean;
+    /** --json: machine-readable output. */
+    json: boolean;
+    /** --file <path>: filter dependency output to one workspace file. */
+    file?: string;
+    /** --force / -f : overwrite existing config during init. */
+    force: boolean;
+    /** --mode: watch mode override. */
+    mode?: 'manual' | 'onChange' | 'idle';
+    /** --kb-only: generate KB artifacts only, skip instruction files. */
+    kbOnly: boolean;
+    /** --copilot: enable Copilot instruction file. */
+    copilot: boolean;
+    /** --cursor: enable Cursor instruction file. */
+    cursor: boolean;
+    /** --claude: enable Claude instruction file. */
+    claude: boolean;
+    /** --other: enable AGENTS.md instruction file. */
+    other: boolean;
+    /** --instructions-mode: instruction generation mode. */
+    instructionsMode?: 'safe' | 'permissive' | 'off';
+    /** --no-color: disable ANSI color output. */
+    noColor: boolean;
+}
+/** Exit codes. */
+export declare const ExitCode: {
+    readonly OK: 0;
+    readonly ERROR: 1;
+    readonly USAGE: 2;
+};
+export type ExitCodeValue = (typeof ExitCode)[keyof typeof ExitCode];
+/** Result returned by every command handler. */
+export interface CommandResult {
+    exitCode: ExitCodeValue;
+    report?: EmitReport;
+}
+/**
+ * Shared context built once in main() and passed to every command handler.
+ *
+ * Eliminates repetitive 4-parameter threading and makes it trivial
+ * to add cross-cutting capabilities (timing, telemetry) later.
+ */
+export interface CommandContext {
+    /** Resolved absolute workspace root. */
+    root: string;
+    /** Parsed CLI flags. */
+    flags: CliFlags;
+    /** Loaded config (undefined when no aspectcode.json exists). */
+    config: AspectCodeConfig | undefined;
+    /** Logger respecting --verbose / --quiet. */
+    log: Logger;
+    /** Raw positional arguments after the command name. */
+    positionals: string[];
+}
+/** Convert a kebab-case flag name to its CliFlags property key. */
+export declare function flagPropName(def: FlagDef): string;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * aspectcode CLI — shared types, flag definitions, and interfaces.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExitCode = exports.FLAG_DEFS = void 0;
+exports.flagPropName = flagPropName;
+/**
+ * Canonical list of every CLI flag. Adding a new flag is a single entry here
+ * — parseArgs() and printHelp() derive from this array automatically.
+ */
+exports.FLAG_DEFS = [
+    { name: 'help', short: 'h', type: 'boolean', description: 'Show this help', appliesTo: 'global' },
+    { name: 'version', short: 'V', type: 'boolean', description: 'Print version', appliesTo: 'global' },
+    { name: 'verbose', short: 'v', type: 'boolean', description: 'Show debug output', appliesTo: 'global' },
+    { name: 'quiet', short: 'q', type: 'boolean', description: 'Suppress non-error output', appliesTo: 'global' },
+    { name: 'root', short: 'r', type: 'string', description: 'Workspace root (default: cwd)', appliesTo: 'global' },
+    { name: 'out', short: 'o', type: 'string', description: 'Output directory override', appliesTo: ['generate'] },
+    { name: 'json', type: 'boolean', description: 'Print JSON output (for automation)', appliesTo: 'global' },
+    { name: 'force', short: 'f', type: 'boolean', description: 'Overwrite existing config (init)', appliesTo: ['init'] },
+    { name: 'no-color', type: 'boolean', description: 'Disable colored output', appliesTo: 'global', prop: 'noColor' },
+    { name: 'file', type: 'string', description: 'Filter by file path', appliesTo: ['generate', 'impact', 'deps'] },
+    { name: 'list-connections', type: 'boolean', description: 'Print dependency connections', appliesTo: ['generate'], prop: 'listConnections' },
+    { name: 'mode', type: 'enum', description: 'Watch mode: manual|onChange|idle', appliesTo: ['watch'], values: ['manual', 'onChange', 'idle'] },
+    { name: 'kb-only', type: 'boolean', description: 'Generate KB artifacts only (skip instruction files)', appliesTo: ['generate'], prop: 'kbOnly' },
+    { name: 'copilot', type: 'boolean', description: 'Enable Copilot instruction file', appliesTo: ['generate'] },
+    { name: 'cursor', type: 'boolean', description: 'Enable Cursor instruction file', appliesTo: ['generate'] },
+    { name: 'claude', type: 'boolean', description: 'Enable Claude instruction file', appliesTo: ['generate'] },
+    { name: 'other', type: 'boolean', description: 'Enable AGENTS.md instruction file', appliesTo: ['generate'] },
+    { name: 'instructions-mode', type: 'enum', description: 'Instruction mode: safe|permissive|off', appliesTo: ['generate'], values: ['safe', 'permissive', 'off'], prop: 'instructionsMode' },
+];
+/** Exit codes. */
+exports.ExitCode = {
+    OK: 0,
+    ERROR: 1,
+    USAGE: 2,
+};
+// ── Flag-def helpers ─────────────────────────────────────────
+/** Convert a kebab-case flag name to its CliFlags property key. */
+function flagPropName(def) {
+    if (def.prop)
+        return def.prop;
+    // kebab-case → camelCase
+    return def.name.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/deps.d.ts

@@ -0,0 +1,3 @@
+import type { CommandContext, CommandResult } from '../cli';
+export declare function runDepsList(ctx: CommandContext): Promise<CommandResult>;
+//# sourceMappingURL=deps.d.ts.map

package/dist/commands/deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../../src/commands/deps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAQ5D,wBAAsB,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAuC7E"}

package/dist/commands/deps.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runDepsList = runDepsList;
+const cli_1 = require("../cli");
+const logger_1 = require("../logger");
+const connections_1 = require("../connections");
+async function runDepsList(ctx) {
+    const { root, flags, config, log } = ctx;
+    const allConnections = await (0, connections_1.collectConnections)(root, config, log);
+    const filtered = (0, connections_1.filterConnectionsByFile)(allConnections, root, flags.file);
+    const connections = filtered.connections;
+    if (filtered.error) {
+        log.error(filtered.error);
+        return { exitCode: cli_1.ExitCode.USAGE };
+    }
+    if (filtered.fileFilter && connections.length === 0) {
+        log.info(`No dependency connections found for ${logger_1.fmt.cyan(filtered.fileFilter)}.`);
+        return { exitCode: cli_1.ExitCode.OK };
+    }
+    if (filtered.fileFilter) {
+        log.info(`Filtering by file: ${logger_1.fmt.cyan(filtered.fileFilter)}`);
+    }
+    if (connections.length === 0) {
+        log.info('No dependency connections found.');
+        return { exitCode: cli_1.ExitCode.OK };
+    }
+    log.info(logger_1.fmt.bold('Dependency connections:'));
+    for (const row of connections) {
+        const symbols = row.symbols.length > 0 ? ` [${row.symbols.join(', ')}]` : '';
+        const lineInfo = row.lines.length > 0 ? ` @${row.lines.join(',')}` : '';
+        const bidi = row.bidirectional ? ' <->' : '';
+        log.info(`${logger_1.fmt.cyan(row.source)} -> ${logger_1.fmt.cyan(row.target)} ` +
+            `(${row.type})${bidi}${symbols}${lineInfo}`);
+    }
+    log.blank();
+    log.info(`${connections.length} connections listed`);
+    return { exitCode: cli_1.ExitCode.OK };
+}
+//# sourceMappingURL=deps.js.map

package/dist/commands/deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps.js","sourceRoot":"","sources":["../../src/commands/deps.ts"],"names":[],"mappings":";;AAQA,kCAuCC;AA9CD,gCAAkC;AAClC,sCAAgC;AAChC,gDAGwB;AAEjB,KAAK,UAAU,WAAW,CAAC,GAAmB;IACnD,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;IACzC,MAAM,cAAc,GAAG,MAAM,IAAA,gCAAkB,EAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IACnE,MAAM,QAAQ,GAAG,IAAA,qCAAuB,EAAC,cAAc,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3E,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC;IAEzC,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC1B,OAAO,EAAE,QAAQ,EAAE,cAAQ,CAAC,KAAK,EAAE,CAAC;IACtC,CAAC;IAED,IAAI,QAAQ,CAAC,UAAU,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpD,GAAG,CAAC,IAAI,CAAC,uCAAuC,YAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAClF,OAAO,EAAE,QAAQ,EAAE,cAAQ,CAAC,EAAE,EAAE,CAAC;IACnC,CAAC;IAED,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;QACxB,GAAG,CAAC,IAAI,CAAC,sBAAsB,YAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,GAAG,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QAC7C,OAAO,EAAE,QAAQ,EAAE,cAAQ,CAAC,EAAE,EAAE,CAAC;IACnC,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,YAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,CAAC;IAC9C,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,GAAG,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,GAAG,CAAC,IAAI,CACN,GAAG,YAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,YAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG;YACnD,IAAI,GAAG,CAAC,IAAI,IAAI,IAAI,GAAG,OAAO,GAAG,QAAQ,EAAE,CAC9C,CAAC;IACJ,CAAC;IAED,GAAG,CAAC,KAAK,EAAE,CAAC;IACZ,GAAG,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,MAAM,qBAAqB,CAAC,CAAC;IACrD,OAAO,EAAE,QAAQ,EAAE,cAAQ,CAAC,EAAE,EAAE,CAAC;AACnC,CAAC"}

package/dist/commands/generate.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `aspectcode generate` — discover, analyze, and emit artifacts.
+ *
+ * Pipeline: discoverFiles → readAll → analyzeRepoWithDependencies → runEmitters → report
+ */
+import type { CommandContext, CommandResult } from '../cli';
+export declare function runGenerate(ctx: CommandContext): Promise<CommandResult>;
+//# sourceMappingURL=generate.d.ts.map

package/dist/commands/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAM5D,wBAAsB,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAoJ7E"}

package/dist/commands/generate.js

@@ -0,0 +1,176 @@
+"use strict";
+/**
+ * `aspectcode generate` — discover, analyze, and emit artifacts.
+ *
+ * Pipeline: discoverFiles → readAll → analyzeRepoWithDependencies → runEmitters → report
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runGenerate = runGenerate;
+const path = __importStar(require("path"));
+const core_1 = require("@aspectcode/core");
+const emitters_1 = require("@aspectcode/emitters");
+const cli_1 = require("../cli");
+const logger_1 = require("../logger");
+const workspace_1 = require("../workspace");
+const connections_1 = require("../connections");
+async function runGenerate(ctx) {
+    const { root, flags, config, log } = ctx;
+    const startMs = Date.now();
+    // ── 1. Resolve options ────────────────────────────────────
+    const outDir = flags.out ?? config?.outDir ?? undefined;
+    const resolvedOut = outDir ? path.resolve(root, outDir) : root;
+    if (!flags.json) {
+        log.info(`Workspace: ${logger_1.fmt.cyan(root)}`);
+        if (outDir)
+            log.info(`Output:    ${logger_1.fmt.cyan(resolvedOut)}`);
+        log.blank();
+    }
+    // ── 2. Discover & read files ───────────────────────────────
+    const workspace = await (0, workspace_1.loadWorkspaceFiles)(root, config, log, { quiet: flags.quiet });
+    if (workspace.discoveredPaths.length === 0) {
+        log.warn('Check your exclude patterns.');
+        return { exitCode: cli_1.ExitCode.ERROR };
+    }
+    const { relativeFiles: fileContents, absoluteFiles: absoluteFileContents } = workspace;
+    // ── 3. Analyze ────────────────────────────────────────────
+    const spinAnalyze = (0, logger_1.createSpinner)('Analyzing…', { quiet: flags.quiet });
+    const model = await (0, core_1.analyzeRepoWithDependencies)(root, fileContents, absoluteFileContents, workspace.host);
+    spinAnalyze.stop(`Analyzed ${model.files.length} files, ${model.graph.edges.length} edges`);
+    // ── 4. Resolve instruction target ─────────────────────────
+    const host = (0, emitters_1.createNodeEmitterHost)();
+    // Determine assistant selection: explicit flags override default.
+    const hasExplicitAssistants = flags.copilot || flags.cursor || flags.claude || flags.other;
+    const assistants = flags.kbOnly
+        ? {}
+        : hasExplicitAssistants
+            ? {
+                copilot: flags.copilot || undefined,
+                cursor: flags.cursor || undefined,
+                claude: flags.claude || undefined,
+                other: flags.other || undefined,
+            }
+            : { other: true };
+    const instructionsMode = flags.kbOnly
+        ? 'off'
+        : (flags.instructionsMode ?? 'safe');
+    if (!flags.kbOnly && !flags.json) {
+        const targets = Object.entries(assistants)
+            .filter(([, v]) => v)
+            .map(([k]) => k);
+        log.info(`Instructions: ${logger_1.fmt.cyan(targets.join(', ') || '(none)')}`);
+    }
+    // ── 5. Emit artifacts ─────────────────────────────────────
+    const spinEmit = (0, logger_1.createSpinner)('Writing artifacts…', { quiet: flags.quiet });
+    const emitOpts = {
+        workspaceRoot: root,
+        outDir: resolvedOut,
+        assistants,
+        instructionsMode,
+        fileContents,
+    };
+    const report = await (0, emitters_1.runEmitters)(model, host, emitOpts);
+    spinEmit.stop(`Wrote ${report.wrote.length} files`);
+    let connections;
+    if (flags.listConnections || flags.json) {
+        const spinDeps = (0, logger_1.createSpinner)('Computing dependencies…', { quiet: flags.quiet });
+        const allConnections = await (0, connections_1.collectConnections)(root, config, log);
+        const filtered = (0, connections_1.filterConnectionsByFile)(allConnections, root, flags.file);
+        if (filtered.error) {
+            spinDeps.fail('Dependency error');
+            log.error(filtered.error);
+            return { exitCode: cli_1.ExitCode.USAGE };
+        }
+        connections = filtered.connections;
+        spinDeps.stop(`Found ${connections.length} connections`);
+        if (filtered.fileFilter && !flags.json) {
+            log.info(`Filtered by: ${logger_1.fmt.cyan(filtered.fileFilter)}`);
+        }
+    }
+    // ── 6. Report ─────────────────────────────────────────────
+    const elapsedMs = Date.now() - startMs;
+    if (flags.json) {
+        const payload = {
+            schemaVersion: report.schemaVersion,
+            wrote: report.wrote.map((w) => ({
+                path: path.relative(root, w.path).replace(/\\/g, '/'),
+                bytes: w.bytes,
+            })),
+            skipped: report.skipped,
+            stats: report.stats,
+            connections,
+        };
+        console.log(JSON.stringify(payload, null, 2));
+    }
+    else {
+        log.blank();
+        for (const w of report.wrote) {
+            const rel = path.relative(root, w.path).replace(/\\/g, '/');
+            log.success(`${rel} (${formatBytes(w.bytes)})`);
+        }
+    }
+    if (report.skipped) {
+        for (const s of report.skipped) {
+            log.debug(`  skipped: ${s.id} — ${s.reason}`);
+        }
+    }
+    if (flags.listConnections && !flags.json) {
+        log.blank();
+        log.info(logger_1.fmt.bold('Dependency connections:'));
+        for (const row of connections ?? []) {
+            const symbols = row.symbols.length > 0 ? ` [${row.symbols.join(', ')}]` : '';
+            const lineInfo = row.lines.length > 0 ? ` @${row.lines.join(',')}` : '';
+            const bidi = row.bidirectional ? ' <->' : '';
+            log.info(`${logger_1.fmt.cyan(row.source)} -> ${logger_1.fmt.cyan(row.target)} ` +
+                `(${row.type})${bidi}${symbols}${lineInfo}`);
+        }
+    }
+    if (!flags.json) {
+        log.blank();
+        log.info(logger_1.fmt.dim(`Done in ${(elapsedMs / 1000).toFixed(1)}s — `) +
+            `${report.wrote.length} files written`);
+    }
+    return { exitCode: cli_1.ExitCode.OK, report };
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    const kb = bytes / 1024;
+    if (kb < 1024)
+        return `${kb.toFixed(1)} KB`;
+    const mb = kb / 1024;
+    return `${mb.toFixed(1)} MB`;
+}
+//# sourceMappingURL=generate.js.map

package/dist/commands/generate.js.map

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

package/dist/commands/impact.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `aspectcode impact` — compute a lightweight impact summary for a single file.
+ *
+ * Discovers workspace files, resolves dependencies, and computes how many
+ * other files depend on the target file.
+ */
+import type { CommandContext, CommandResult } from '../cli';
+export declare function runImpact(ctx: CommandContext): Promise<CommandResult>;
+//# sourceMappingURL=impact.d.ts.map

package/dist/commands/impact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact.d.ts","sourceRoot":"","sources":["../../src/commands/impact.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EAAY,cAAc,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAiBtE,wBAAsB,SAAS,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CA0F3E"}

package/dist/commands/impact.js

@@ -0,0 +1,162 @@
+"use strict";
+/**
+ * `aspectcode impact` — compute a lightweight impact summary for a single file.
+ *
+ * Discovers workspace files, resolves dependencies, and computes how many
+ * other files depend on the target file.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runImpact = runImpact;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const core_1 = require("@aspectcode/core");
+const cli_1 = require("../cli");
+const logger_1 = require("../logger");
+const workspace_1 = require("../workspace");
+// ── Command handler ──────────────────────────────────────────
+async function runImpact(ctx) {
+    const { root, flags, config, log } = ctx;
+    const targetFile = flags.file;
+    if (!targetFile) {
+        log.error(`${logger_1.fmt.bold('--file')} is required for the impact command.`);
+        return { exitCode: cli_1.ExitCode.USAGE };
+    }
+    const absoluteTarget = path.resolve(root, targetFile);
+    // Verify the target file exists.
+    if (!fs.existsSync(absoluteTarget)) {
+        log.error(`File not found: ${logger_1.fmt.cyan(absoluteTarget)}`);
+        return { exitCode: cli_1.ExitCode.ERROR };
+    }
+    // Discover and read files using shared helper.
+    const workspace = await (0, workspace_1.loadWorkspaceFiles)(root, config, log, { quiet: flags.quiet });
+    if (workspace.discoveredPaths.length === 0) {
+        return { exitCode: cli_1.ExitCode.ERROR };
+    }
+    // Analyze dependencies.
+    const analyzer = new core_1.DependencyAnalyzer();
+    analyzer.setFileContentsCache(workspace.absoluteFiles);
+    const links = await analyzer.analyzeDependencies(workspace.discoveredPaths, workspace.host);
+    // Compute degree stats.
+    const stats = new Map();
+    for (const file of workspace.discoveredPaths) {
+        stats.set(file, { inDegree: 0, outDegree: 0 });
+    }
+    for (const link of links) {
+        const src = stats.get(link.source);
+        const tgt = stats.get(link.target);
+        if (src)
+            src.outDegree++;
+        if (tgt)
+            tgt.inDegree++;
+    }
+    // Compute impact summary.
+    const normalizedTarget = path.resolve(absoluteTarget);
+    const targetClass = (0, core_1.classifyFile)(normalizedTarget, root);
+    if (targetClass === 'third_party') {
+        const summary = {
+            file: rel(normalizedTarget, root),
+            dependents_count: 0,
+            top_dependents: [],
+            generated_at: new Date().toISOString(),
+        };
+        return outputSummary(summary, flags, log);
+    }
+    const dependentAbs = dedupe(links
+        .filter((l) => l.target && path.resolve(l.target) === normalizedTarget)
+        .map((l) => l.source)
+        .filter(Boolean)
+        .filter((s) => s !== normalizedTarget)
+        .filter((s) => (0, core_1.classifyFile)(s, root) !== 'third_party'));
+    const appOrTestDependents = dependentAbs.filter((s) => {
+        const c = (0, core_1.classifyFile)(s, root);
+        return c === 'app' || c === 'test';
+    });
+    const dependentsToUse = appOrTestDependents.length > 0 ? appOrTestDependents : dependentAbs;
+    const dependentsWithCounts = dependentsToUse
+        .map((dep) => ({
+        abs: dep,
+        dependent_count: stats.get(dep)?.inDegree ?? 0,
+    }))
+        .sort((a, b) => b.dependent_count - a.dependent_count || a.abs.localeCompare(b.abs));
+    const dependentsCount = dependentsWithCounts.length;
+    const topDependents = dependentsWithCounts.slice(0, 5).map((d) => ({
+        file: rel(d.abs, root),
+        dependent_count: d.dependent_count,
+    }));
+    const summary = {
+        file: rel(normalizedTarget, root),
+        dependents_count: dependentsCount,
+        top_dependents: topDependents,
+        generated_at: new Date().toISOString(),
+    };
+    return outputSummary(summary, flags, log);
+}
+// ── Helpers ──────────────────────────────────────────────────
+function outputSummary(summary, flags, log) {
+    if (flags.json) {
+        console.log(JSON.stringify(summary, null, 2));
+    }
+    else {
+        log.info(`File: ${logger_1.fmt.cyan(summary.file)}`);
+        log.info(`Dependents: ${logger_1.fmt.bold(String(summary.dependents_count))}`);
+        if (summary.top_dependents.length > 0) {
+            log.info('Top dependents:');
+            for (const dep of summary.top_dependents) {
+                log.info(`  - ${dep.file} (${dep.dependent_count} dependents)`);
+            }
+        }
+    }
+    return { exitCode: cli_1.ExitCode.OK };
+}
+function rel(absPath, workspaceRoot) {
+    const normalized = absPath.replace(/\\/g, '/');
+    const normalizedRoot = workspaceRoot.replace(/\\/g, '/').replace(/\/$/, '');
+    if (normalized.startsWith(normalizedRoot)) {
+        return normalized.substring(normalizedRoot.length).replace(/^\//, '');
+    }
+    return path.basename(absPath);
+}
+function dedupe(items) {
+    const seen = new Set();
+    return items.filter((item) => {
+        const key = String(item);
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+//# sourceMappingURL=impact.js.map

package/dist/commands/impact.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `aspectcode init` — create an `aspectcode.json` config file.
+ */
+import type { CommandContext, CommandResult } from '../cli';
+import { runWatch } from './watch';
+interface InitDeps {
+    runWatchFn?: typeof runWatch;
+}
+export declare function runInit(ctx: CommandContext, deps?: InitDeps): Promise<CommandResult>;
+export {};
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,OAAO,KAAK,EAAY,cAAc,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAItE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAInC,UAAU,QAAQ;IAChB,UAAU,CAAC,EAAE,OAAO,QAAQ,CAAC;CAC9B;AAED,wBAAsB,OAAO,CAC3B,GAAG,EAAE,cAAc,EACnB,IAAI,GAAE,QAAa,GAClB,OAAO,CAAC,aAAa,CAAC,CAmCxB"}