aspectcode 0.2.0

package/dist/config.d.ts

@@ -0,0 +1,38 @@
+/**
+ * aspectcode CLI — config file handling.
+ *
+ * The CLI looks for `aspectcode.json` in the workspace root.
+ * This replaces the extension's `.aspect/.settings.json`.
+ */
+export declare const CONFIG_FILE_NAME = "aspectcode.json";
+/** Shape of `aspectcode.json`. */
+export interface AspectCodeConfig {
+    /** Override output directory (relative to workspace root). */
+    outDir?: string;
+    /** Instructions mode (safe-only for now). */
+    instructionsMode?: 'safe';
+    /** Auto-update trigger mode. */
+    updateRate?: 'manual' | 'onChange' | 'idle';
+    /** Extra directories to exclude from analysis. */
+    exclude?: string[];
+}
+export type RawAspectCodeConfig = Record<string, unknown>;
+/** Default config written by `aspectcode init`. */
+export declare function defaultConfig(): AspectCodeConfig;
+/**
+ * Load `aspectcode.json` from `root`. Returns `undefined` if not found.
+ * Throws on parse errors.
+ */
+export declare function loadConfig(root: string): AspectCodeConfig | undefined;
+/**
+ * Load raw `aspectcode.json` object from `root`.
+ * Returns `undefined` if not found.
+ */
+export declare function loadRawConfig(root: string): RawAspectCodeConfig | undefined;
+/**
+ * Save raw config object to `aspectcode.json`.
+ */
+export declare function saveRawConfig(root: string, config: RawAspectCodeConfig): void;
+/** Resolve the config file path for a given root. */
+export declare function configPath(root: string): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,eAAO,MAAM,gBAAgB,oBAAoB,CAAC;AAElD,kCAAkC;AAClC,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,6CAA6C;IAC7C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,gCAAgC;IAChC,UAAU,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;IAE5C,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1D,mDAAmD;AACnD,wBAAgB,aAAa,IAAI,gBAAgB,CAKhD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CA4BrE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAiB3E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAI7E;AAED,qDAAqD;AACrD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/dist/config.js

@@ -0,0 +1,119 @@
+"use strict";
+/**
+ * aspectcode CLI — config file handling.
+ *
+ * The CLI looks for `aspectcode.json` in the workspace root.
+ * This replaces the extension's `.aspect/.settings.json`.
+ */
+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.CONFIG_FILE_NAME = void 0;
+exports.defaultConfig = defaultConfig;
+exports.loadConfig = loadConfig;
+exports.loadRawConfig = loadRawConfig;
+exports.saveRawConfig = saveRawConfig;
+exports.configPath = configPath;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+exports.CONFIG_FILE_NAME = 'aspectcode.json';
+/** Default config written by `aspectcode init`. */
+function defaultConfig() {
+    return {
+        instructionsMode: 'safe',
+        updateRate: 'onChange',
+    };
+}
+/**
+ * Load `aspectcode.json` from `root`. Returns `undefined` if not found.
+ * Throws on parse errors.
+ */
+function loadConfig(root) {
+    const configPath = path.join(root, exports.CONFIG_FILE_NAME);
+    if (!fs.existsSync(configPath))
+        return undefined;
+    const raw = fs.readFileSync(configPath, 'utf-8');
+    try {
+        const parsed = JSON.parse(raw);
+        // Backward compat: extension-style mode key.
+        if (!parsed.updateRate && parsed.autoRegenerateKb) {
+            parsed.updateRate =
+                parsed.autoRegenerateKb === 'off'
+                    ? 'manual'
+                    : parsed.autoRegenerateKb === 'onSave'
+                        ? 'onChange'
+                        : 'idle';
+        }
+        // Safe-only policy.
+        parsed.instructionsMode = 'safe';
+        return parsed;
+    }
+    catch {
+        throw new Error(`Failed to parse ${exports.CONFIG_FILE_NAME}: invalid JSON`);
+    }
+}
+/**
+ * Load raw `aspectcode.json` object from `root`.
+ * Returns `undefined` if not found.
+ */
+function loadRawConfig(root) {
+    const filePath = path.join(root, exports.CONFIG_FILE_NAME);
+    if (!fs.existsSync(filePath))
+        return undefined;
+    const raw = fs.readFileSync(filePath, 'utf-8');
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new Error(`Failed to parse ${exports.CONFIG_FILE_NAME}: invalid JSON`);
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error(`Failed to parse ${exports.CONFIG_FILE_NAME}: expected JSON object`);
+    }
+    return parsed;
+}
+/**
+ * Save raw config object to `aspectcode.json`.
+ */
+function saveRawConfig(root, config) {
+    const filePath = configPath(root);
+    const content = JSON.stringify(config, null, 2) + '\n';
+    fs.writeFileSync(filePath, content, 'utf-8');
+}
+/** Resolve the config file path for a given root. */
+function configPath(root) {
+    return path.join(root, exports.CONFIG_FILE_NAME);
+}
+//# 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;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyBH,sCAKC;AAMD,gCA4BC;AAMD,sCAiBC;AAKD,sCAIC;AAGD,gCAEC;AAnGD,uCAAyB;AACzB,2CAA6B;AAEhB,QAAA,gBAAgB,GAAG,iBAAiB,CAAC;AAmBlD,mDAAmD;AACnD,SAAgB,aAAa;IAC3B,OAAO;QACL,gBAAgB,EAAE,MAAM;QACxB,UAAU,EAAE,UAAU;KACvB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,UAAU,CAAC,IAAY;IACrC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,wBAAgB,CAAC,CAAC;IACrD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,SAAS,CAAC;IAEjD,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACjD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAG5B,CAAC;QAEF,6CAA6C;QAC7C,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAClD,MAAM,CAAC,UAAU;gBACf,MAAM,CAAC,gBAAgB,KAAK,KAAK;oBAC/B,CAAC,CAAC,QAAQ;oBACV,CAAC,CAAC,MAAM,CAAC,gBAAgB,KAAK,QAAQ;wBACpC,CAAC,CAAC,UAAU;wBACZ,CAAC,CAAC,MAAM,CAAC;QACjB,CAAC;QAED,oBAAoB;QACpB,MAAM,CAAC,gBAAgB,GAAG,MAAM,CAAC;QAEjC,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,mBAAmB,wBAAgB,gBAAgB,CAAC,CAAC;IACvE,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAC,IAAY;IACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,wBAAgB,CAAC,CAAC;IACnD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IAE/C,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC/C,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,mBAAmB,wBAAgB,gBAAgB,CAAC,CAAC;IACvE,CAAC;IAED,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,mBAAmB,wBAAgB,wBAAwB,CAAC,CAAC;IAC/E,CAAC;IAED,OAAO,MAA6B,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,IAAY,EAAE,MAA2B;IACrE,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IACvD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED,qDAAqD;AACrD,SAAgB,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,wBAAgB,CAAC,CAAC;AAC3C,CAAC"}

package/dist/connections.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Shared dependency-connection utilities for CLI commands.
+ *
+ * Extracted from deps.ts so that both `deps` and `generate` can use
+ * them without a command→command import dependency.
+ */
+import type { AspectCodeConfig } from './config';
+import type { Logger } from './logger';
+export interface DependencyConnection {
+    source: string;
+    target: string;
+    type: string;
+    symbols: string[];
+    lines: number[];
+    bidirectional: boolean;
+}
+export interface FilteredConnectionsResult {
+    connections: DependencyConnection[];
+    fileFilter?: string;
+    error?: string;
+}
+export declare function filterConnectionsByFile(connections: DependencyConnection[], root: string, file?: string): FilteredConnectionsResult;
+export declare function collectConnections(root: string, config: AspectCodeConfig | undefined, log: Logger): Promise<DependencyConnection[]>;
+//# sourceMappingURL=connections.d.ts.map

package/dist/connections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connections.d.ts","sourceRoot":"","sources":["../src/connections.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAIvC,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAWD,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,oBAAoB,EAAE,EACnC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,GACZ,yBAAyB,CAmB3B;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,gBAAgB,GAAG,SAAS,EACpC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAkBjC"}

package/dist/connections.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * Shared dependency-connection utilities for CLI commands.
+ *
+ * Extracted from deps.ts so that both `deps` and `generate` can use
+ * them without a command→command import dependency.
+ */
+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.filterConnectionsByFile = filterConnectionsByFile;
+exports.collectConnections = collectConnections;
+const path = __importStar(require("path"));
+const core_1 = require("@aspectcode/core");
+const logger_1 = require("./logger");
+const workspace_1 = require("./workspace");
+function normalizeWorkspacePath(candidate, root) {
+    const abs = path.resolve(root, candidate);
+    const rel = path.relative(root, abs);
+    if (rel.startsWith('..') || path.isAbsolute(rel)) {
+        return undefined;
+    }
+    return rel.replace(/\\/g, '/');
+}
+function filterConnectionsByFile(connections, root, file) {
+    if (!file) {
+        return { connections };
+    }
+    const fileRel = normalizeWorkspacePath(file, root);
+    if (!fileRel) {
+        return {
+            connections: [],
+            error: `--file must point to a file inside the workspace: ${logger_1.fmt.bold(file)}`,
+        };
+    }
+    return {
+        connections: connections.filter((row) => row.source === fileRel || row.target === fileRel),
+        fileFilter: fileRel,
+    };
+}
+async function collectConnections(root, config, log) {
+    const workspace = await (0, workspace_1.loadWorkspaceFiles)(root, config, log, { quiet: true });
+    if (workspace.discoveredPaths.length === 0) {
+        return [];
+    }
+    const analyzer = new core_1.DependencyAnalyzer();
+    analyzer.setFileContentsCache(workspace.absoluteFiles);
+    const edges = await analyzer.analyzeDependencies(workspace.discoveredPaths, workspace.host);
+    return edges.map((edge) => ({
+        source: path.relative(root, edge.source).replace(/\\/g, '/'),
+        target: path.relative(root, edge.target).replace(/\\/g, '/'),
+        type: edge.type,
+        symbols: edge.symbols,
+        lines: edge.lines,
+        bidirectional: edge.bidirectional,
+    }));
+}
+//# sourceMappingURL=connections.js.map

package/dist/connections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connections.js","sourceRoot":"","sources":["../src/connections.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCH,0DAuBC;AAED,gDAsBC;AAhFD,2CAA6B;AAC7B,2CAE0B;AAG1B,qCAA+B;AAC/B,2CAAiD;AAiBjD,SAAS,sBAAsB,CAAC,SAAiB,EAAE,IAAY;IAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACrC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACjD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACjC,CAAC;AAED,SAAgB,uBAAuB,CACrC,WAAmC,EACnC,IAAY,EACZ,IAAa;IAEb,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,WAAW,EAAE,CAAC;IACzB,CAAC;IAED,MAAM,OAAO,GAAG,sBAAsB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACnD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,WAAW,EAAE,EAAE;YACf,KAAK,EAAE,qDAAqD,YAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SAC7E,CAAC;IACJ,CAAC;IAED,OAAO;QACL,WAAW,EAAE,WAAW,CAAC,MAAM,CAC7B,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,OAAO,IAAI,GAAG,CAAC,MAAM,KAAK,OAAO,CAC1D;QACD,UAAU,EAAE,OAAO;KACpB,CAAC;AACJ,CAAC;AAEM,KAAK,UAAU,kBAAkB,CACtC,IAAY,EACZ,MAAoC,EACpC,GAAW;IAEX,MAAM,SAAS,GAAG,MAAM,IAAA,8BAAkB,EAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/E,IAAI,SAAS,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3C,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,yBAAkB,EAAE,CAAC;IAC1C,QAAQ,CAAC,oBAAoB,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,mBAAmB,CAAC,SAAS,CAAC,eAAe,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IAE5F,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1B,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;QAC5D,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;QAC5D,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,aAAa,EAAE,IAAI,CAAC,aAAa;KAClC,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,45 @@
+/**
+ * aspectcode CLI — zero-dependency logger with optional color.
+ *
+ * Respects NO_COLOR / FORCE_COLOR environment variables and --no-color flag.
+ */
+/** Call before creating a logger to force color off (e.g. --no-color flag). */
+export declare function disableColor(): void;
+export interface Logger {
+    info(msg: string): void;
+    success(msg: string): void;
+    warn(msg: string): void;
+    error(msg: string): void;
+    debug(msg: string): void;
+    blank(): void;
+}
+export declare function createLogger(opts?: {
+    verbose?: boolean;
+    quiet?: boolean;
+}): Logger;
+export interface Spinner {
+    /** Update the spinner text (same line). */
+    update(msg: string): void;
+    /** Stop the spinner with a success checkmark. */
+    stop(msg: string): void;
+    /** Stop the spinner with a failure mark. */
+    fail(msg: string): void;
+}
+/**
+ * Create a stderr-based spinner that doesn't pollute stdout.
+ * Falls back to static lines on non-TTY or when quiet.
+ */
+export declare function createSpinner(initialMsg: string, opts?: {
+    quiet?: boolean;
+}): Spinner;
+/** Formatting helpers (exported for use in commands). */
+export declare const fmt: {
+    readonly bold: (t: string) => string;
+    readonly dim: (t: string) => string;
+    readonly green: (t: string) => string;
+    readonly yellow: (t: string) => string;
+    readonly red: (t: string) => string;
+    readonly cyan: (t: string) => string;
+    readonly blue: (t: string) => string;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,+EAA+E;AAC/E,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAwBD,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,YAAY,CAAC,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,CAwBtF;AAMD,MAAM,WAAW,OAAO;IACtB,2CAA2C;IAC3C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iDAAiD;IACjD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,4CAA4C;IAC5C,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAiDrF;AAED,yDAAyD;AACzD,eAAO,MAAM,GAAG;uBAhHC,MAAM;sBACP,MAAM;wBACJ,MAAM;yBACL,MAAM;sBACT,MAAM;uBACL,MAAM;uBACN,MAAM;CA0GkD,CAAC"}

package/dist/logger.js

@@ -0,0 +1,116 @@
+"use strict";
+/**
+ * aspectcode CLI — zero-dependency logger with optional color.
+ *
+ * Respects NO_COLOR / FORCE_COLOR environment variables and --no-color flag.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fmt = void 0;
+exports.disableColor = disableColor;
+exports.createLogger = createLogger;
+exports.createSpinner = createSpinner;
+let _colorDisabled = false;
+/** Call before creating a logger to force color off (e.g. --no-color flag). */
+function disableColor() {
+    _colorDisabled = true;
+}
+function colorEnabled() {
+    if (_colorDisabled)
+        return false;
+    return (process.env['FORCE_COLOR'] === '1' ||
+        (!process.env['NO_COLOR'] &&
+            !process.env['CI'] &&
+            process.stdout.isTTY === true));
+}
+function wrap(code, reset, text) {
+    return colorEnabled() ? `\x1b[${code}m${text}\x1b[${reset}m` : text;
+}
+const bold = (t) => wrap('1', '22', t);
+const dim = (t) => wrap('2', '22', t);
+const green = (t) => wrap('32', '39', t);
+const yellow = (t) => wrap('33', '39', t);
+const red = (t) => wrap('31', '39', t);
+const cyan = (t) => wrap('36', '39', t);
+const blue = (t) => wrap('34', '39', t);
+function createLogger(opts = {}) {
+    const isQuiet = opts.quiet ?? false;
+    const isVerbose = opts.verbose ?? false;
+    return {
+        info(msg) {
+            if (!isQuiet)
+                console.log(msg);
+        },
+        success(msg) {
+            if (!isQuiet)
+                console.log(green(bold('✔')) + ' ' + msg);
+        },
+        warn(msg) {
+            console.warn(yellow(bold('⚠')) + ' ' + msg);
+        },
+        error(msg) {
+            console.error(red(bold('✖')) + ' ' + msg);
+        },
+        debug(msg) {
+            if (isVerbose && !isQuiet)
+                console.log(dim(msg));
+        },
+        blank() {
+            if (!isQuiet)
+                console.log();
+        },
+    };
+}
+// ── Spinner ─────────────────────────────────────────────────
+const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+/**
+ * Create a stderr-based spinner that doesn't pollute stdout.
+ * Falls back to static lines on non-TTY or when quiet.
+ */
+function createSpinner(initialMsg, opts) {
+    const isQuiet = opts?.quiet ?? false;
+    const isTTY = process.stderr.isTTY === true;
+    if (isQuiet) {
+        // Silent — no output at all.
+        return {
+            update() { },
+            stop() { },
+            fail(msg) { process.stderr.write(red(bold('✖')) + ' ' + msg + '\n'); },
+        };
+    }
+    if (!isTTY) {
+        // Non-TTY — static lines, no animation.
+        process.stderr.write(initialMsg + '\n');
+        return {
+            update(msg) { process.stderr.write(msg + '\n'); },
+            stop(msg) { process.stderr.write(green(bold('✔')) + ' ' + msg + '\n'); },
+            fail(msg) { process.stderr.write(red(bold('✖')) + ' ' + msg + '\n'); },
+        };
+    }
+    // TTY — animated spinner on stderr.
+    let frame = 0;
+    let currentMsg = initialMsg;
+    const interval = setInterval(() => {
+        const indicator = cyan(SPINNER_FRAMES[frame % SPINNER_FRAMES.length]);
+        process.stderr.write(`\r\x1b[K${indicator} ${currentMsg}`);
+        frame++;
+    }, 80);
+    // Show initial frame immediately.
+    const indicator = cyan(SPINNER_FRAMES[0]);
+    process.stderr.write(`${indicator} ${currentMsg}`);
+    return {
+        update(msg) {
+            currentMsg = msg;
+        },
+        stop(msg) {
+            clearInterval(interval);
+            process.stderr.write(`\r\x1b[K${green(bold('✔'))} ${msg}\n`);
+        },
+        fail(msg) {
+            clearInterval(interval);
+            process.stderr.write(`\r\x1b[K${red(bold('✖'))} ${msg}\n`);
+        },
+    };
+}
+/** Formatting helpers (exported for use in commands). */
+exports.fmt = { bold, dim, green, yellow, red, cyan, blue };
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/main.d.ts

@@ -0,0 +1,12 @@
+/**
+ * aspectcode CLI — main entry point.
+ *
+ * Hand-rolled argv parser (no external deps). Routes to command handlers.
+ * Flag definitions live in cli.ts (FLAG_DEFS) — parseArgs and printHelp
+ * derive from that single source of truth.
+ */
+import type { CliArgs } from './cli';
+export declare function parseArgs(argv: string[]): CliArgs;
+/** Entry point — called from bin/aspectcode.js. */
+export declare function run(): void;
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,OAAO,EAA2B,MAAM,OAAO,CAAC;AA+B9D,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAoEjD;AAwKD,mDAAmD;AACnD,wBAAgB,GAAG,IAAI,IAAI,CAK1B"}