aspectcode 0.2.0

package/dist/main.js

@@ -0,0 +1,275 @@
+"use strict";
+/**
+ * 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.
+ */
+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.parseArgs = parseArgs;
+exports.run = run;
+const path = __importStar(require("path"));
+const cli_1 = require("./cli");
+const config_1 = require("./config");
+const logger_1 = require("./logger");
+const version_1 = require("./version");
+const init_1 = require("./commands/init");
+const generate_1 = require("./commands/generate");
+const deps_1 = require("./commands/deps");
+const watch_1 = require("./commands/watch");
+const impact_1 = require("./commands/impact");
+const settings_1 = require("./commands/settings");
+// ── Build lookup tables from FLAG_DEFS ───────────────────────
+/** Map --long-name → FlagDef */
+const longMap = new Map(cli_1.FLAG_DEFS.map((d) => [`--${d.name}`, d]));
+/** Map -x → FlagDef */
+const shortMap = new Map(cli_1.FLAG_DEFS.filter((d) => d.short).map((d) => [`-${d.short}`, d]));
+// ── Argv parsing ─────────────────────────────────────────────
+function parseArgs(argv) {
+    const flags = {
+        help: false,
+        version: false,
+        verbose: false,
+        quiet: false,
+        listConnections: false,
+        json: false,
+        force: false,
+        kbOnly: false,
+        copilot: false,
+        cursor: false,
+        claude: false,
+        other: false,
+        noColor: false,
+    };
+    const positionals = [];
+    let command = '';
+    const args = argv.slice(2); // skip node + script
+    let i = 0;
+    while (i < args.length) {
+        const arg = args[i];
+        // Try --long-name or -x lookup
+        const eqIdx = arg.indexOf('=');
+        const key = eqIdx > 0 ? arg.slice(0, eqIdx) : arg;
+        const def = longMap.get(key) ?? shortMap.get(key);
+        if (def) {
+            const prop = (0, cli_1.flagPropName)(def);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const record = flags;
+            if (def.type === 'boolean') {
+                record[prop] = true;
+            }
+            else if (def.type === 'string') {
+                const val = eqIdx > 0 ? arg.slice(eqIdx + 1) : args[++i];
+                record[prop] = val;
+            }
+            else if (def.type === 'enum' && def.values) {
+                const val = eqIdx > 0 ? arg.slice(eqIdx + 1) : args[++i];
+                if (def.values.includes(val)) {
+                    record[prop] = val;
+                }
+            }
+        }
+        else if (arg.startsWith('--') && eqIdx > 0) {
+            // Unknown --flag=value — try lookup by prefix before '='
+            const stderr = process.stderr;
+            if (stderr && typeof stderr.write === 'function') {
+                stderr.write(`Warning: unknown flag ${key}\n`);
+            }
+        }
+        else if (arg.startsWith('-')) {
+            // Unknown flag — warn but keep going for forward compat
+            const stderr = process.stderr;
+            if (stderr && typeof stderr.write === 'function') {
+                stderr.write(`Warning: unknown flag ${arg}\n`);
+            }
+        }
+        else if (!command) {
+            command = arg;
+        }
+        else {
+            positionals.push(arg);
+        }
+        i++;
+    }
+    return { command, flags, positionals };
+}
+// ── Help text ────────────────────────────────────────────────
+function printHelp() {
+    const optionLines = [];
+    for (const def of cli_1.FLAG_DEFS) {
+        const shortPart = def.short ? `-${def.short}, ` : '    ';
+        const longPart = `--${def.name}`;
+        const valuePart = def.type === 'string' ? ' <value>' :
+            def.type === 'enum' ? ` <${(def.values ?? []).join('|')}>` : '';
+        const left = `  ${shortPart}${longPart}${valuePart}`;
+        const pad = Math.max(2, 30 - left.length);
+        optionLines.push(`${left}${' '.repeat(pad)}${def.description}`);
+    }
+    console.log(`
+${logger_1.fmt.bold('aspectcode')} — generate AI-assistant knowledge bases from your codebase
+
+${logger_1.fmt.bold('USAGE')}
+  aspectcode <command> [options]
+
+${logger_1.fmt.bold('COMMANDS')}
+  init                     Create an ${logger_1.fmt.cyan('aspectcode.json')} config file
+  generate  ${logger_1.fmt.dim('(gen, g)')}       Discover, analyze, and emit KB artifacts
+  watch                    Watch source files and regenerate on changes
+  impact                   Compute impact analysis for a file
+  deps list                List dependency connections
+  show-config              Show current ${logger_1.fmt.cyan('aspectcode.json')} values
+  set-update-rate <mode>   Set updateRate to manual|onChange|idle
+  set-out-dir <path>       Set outDir
+  clear-out-dir            Remove outDir
+  add-exclude <path>       Add an exclude path
+  remove-exclude <path>    Remove an exclude path
+
+${logger_1.fmt.bold('OPTIONS')}
+${optionLines.join('\n')}
+
+${logger_1.fmt.bold('EXAMPLES')}
+  aspectcode init
+  aspectcode generate
+  aspectcode gen --copilot --cursor
+  aspectcode g --json
+  aspectcode impact --file src/app.ts
+  aspectcode deps list --file src/app.ts
+  aspectcode watch --mode idle
+`.trimStart());
+}
+// ── Main ─────────────────────────────────────────────────────
+async function main() {
+    const parsed = parseArgs(process.argv);
+    const { command, flags } = parsed;
+    // Global flags that exit early
+    if (flags.version) {
+        console.log((0, version_1.getVersion)());
+        process.exitCode = cli_1.ExitCode.OK;
+        return;
+    }
+    if (flags.help) {
+        printHelp();
+        process.exitCode = cli_1.ExitCode.OK;
+        return;
+    }
+    if (!command) {
+        printHelp();
+        process.exitCode = cli_1.ExitCode.USAGE;
+        return;
+    }
+    // Apply --no-color before any output
+    if (flags.noColor) {
+        (0, logger_1.disableColor)();
+    }
+    const log = (0, logger_1.createLogger)({ verbose: flags.verbose, quiet: flags.quiet });
+    const root = path.resolve(flags.root ?? process.cwd());
+    // Build shared context — loadConfig returns undefined when no aspectcode.json exists
+    const config = (0, config_1.loadConfig)(root);
+    const ctx = {
+        root,
+        flags,
+        config,
+        log,
+        positionals: parsed.positionals,
+    };
+    let result;
+    switch (command) {
+        case 'init':
+            result = await (0, init_1.runInit)(ctx);
+            break;
+        case 'generate':
+        case 'gen':
+        case 'g':
+            result = await (0, generate_1.runGenerate)(ctx);
+            break;
+        case 'deps': {
+            const sub = parsed.positionals[0] ?? 'list';
+            if (sub !== 'list') {
+                log.error(`Unknown deps subcommand: ${logger_1.fmt.bold(sub)}`);
+                result = { exitCode: cli_1.ExitCode.USAGE };
+                break;
+            }
+            result = await (0, deps_1.runDepsList)(ctx);
+            break;
+        }
+        case 'watch':
+            result = await (0, watch_1.runWatch)(ctx);
+            break;
+        case 'impact':
+            result = await (0, impact_1.runImpact)(ctx);
+            break;
+        case 'show-config':
+            result = await (0, settings_1.runShowConfig)(ctx);
+            break;
+        case 'set-update-rate': {
+            const value = parsed.positionals[0] ?? '';
+            result = await (0, settings_1.runSetUpdateRate)(ctx, value);
+            break;
+        }
+        case 'set-out-dir': {
+            const value = parsed.positionals[0] ?? '';
+            result = await (0, settings_1.runSetOutDir)(ctx, value);
+            break;
+        }
+        case 'clear-out-dir':
+            result = await (0, settings_1.runClearOutDir)(ctx);
+            break;
+        case 'add-exclude': {
+            const value = parsed.positionals[0] ?? '';
+            result = await (0, settings_1.runAddExclude)(ctx, value);
+            break;
+        }
+        case 'remove-exclude': {
+            const value = parsed.positionals[0] ?? '';
+            result = await (0, settings_1.runRemoveExclude)(ctx, value);
+            break;
+        }
+        default:
+            log.error(`Unknown command: ${logger_1.fmt.bold(command)}`);
+            log.info(`Run ${logger_1.fmt.bold('aspectcode --help')} for usage.`);
+            result = { exitCode: cli_1.ExitCode.USAGE };
+    }
+    process.exitCode = result.exitCode;
+}
+/** Entry point — called from bin/aspectcode.js. */
+function run() {
+    main().catch((err) => {
+        console.error(err.message);
+        process.exitCode = cli_1.ExitCode.ERROR;
+    });
+}
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,8 @@
+/**
+ * aspectcode CLI — version helper.
+ *
+ * Reads the version from cli/package.json at runtime, so it stays in sync
+ * without a build step.
+ */
+export declare function getVersion(): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,wBAAgB,UAAU,IAAI,MAAM,CAQnC"}

package/dist/version.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * aspectcode CLI — version helper.
+ *
+ * Reads the version from cli/package.json at runtime, so it stays in sync
+ * without a build step.
+ */
+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.getVersion = getVersion;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+let _cached;
+function getVersion() {
+    if (_cached)
+        return _cached;
+    const pkgPath = path.resolve(__dirname, '..', 'package.json');
+    const raw = fs.readFileSync(pkgPath, 'utf-8');
+    const pkg = JSON.parse(raw);
+    _cached = pkg.version;
+    return _cached;
+}
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOH,gCAQC;AAbD,2CAA6B;AAC7B,uCAAyB;AAEzB,IAAI,OAA2B,CAAC;AAEhC,SAAgB,UAAU;IACxB,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAE5B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;IAC9D,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAwB,CAAC;IACnD,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;IACtB,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/workspace.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Shared workspace file-loading utilities for CLI commands.
+ *
+ * Encapsulates the discover → read → Map pipeline that deps, impact,
+ * and generate all need, eliminating repeated boilerplate.
+ */
+import { type CoreHost } from '@aspectcode/core';
+import type { AspectCodeConfig } from './config';
+import type { Logger } from './logger';
+export interface WorkspaceFiles {
+    /** Map of relative (posix) path → file content */
+    relativeFiles: Map<string, string>;
+    /** Map of absolute path → file content */
+    absoluteFiles: Map<string, string>;
+    /** Absolute paths returned by discoverFiles */
+    discoveredPaths: string[];
+    /** Pre-built host for the workspace (undefined when WASM dir cannot be resolved) */
+    host: CoreHost | undefined;
+}
+/**
+ * Discover and read all source files in the workspace.
+ *
+ * Returns both relative-keyed and absolute-keyed maps (the former for
+ * `analyzeRepo`, the latter for `DependencyAnalyzer`).
+ *
+ * @param root    Absolute workspace root
+ * @param config  Loaded config (used for exclude patterns)
+ * @param log     Logger for debug output
+ * @param opts    Options: quiet suppresses spinners
+ */
+export declare function loadWorkspaceFiles(root: string, config: AspectCodeConfig | undefined, log: Logger, opts?: {
+    quiet?: boolean;
+}): Promise<WorkspaceFiles>;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAGL,KAAK,QAAQ,EACd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGvC,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,0CAA0C;IAC1C,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,+CAA+C;IAC/C,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,oFAAoF;IACpF,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;CAC5B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,gBAAgB,GAAG,SAAS,EACpC,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GACzB,OAAO,CAAC,cAAc,CAAC,CAqCzB"}

package/dist/workspace.js

@@ -0,0 +1,94 @@
+"use strict";
+/**
+ * Shared workspace file-loading utilities for CLI commands.
+ *
+ * Encapsulates the discover → read → Map pipeline that deps, impact,
+ * and generate all need, eliminating repeated boilerplate.
+ */
+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.loadWorkspaceFiles = loadWorkspaceFiles;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const core_1 = require("@aspectcode/core");
+const logger_1 = require("./logger");
+/**
+ * Discover and read all source files in the workspace.
+ *
+ * Returns both relative-keyed and absolute-keyed maps (the former for
+ * `analyzeRepo`, the latter for `DependencyAnalyzer`).
+ *
+ * @param root    Absolute workspace root
+ * @param config  Loaded config (used for exclude patterns)
+ * @param log     Logger for debug output
+ * @param opts    Options: quiet suppresses spinners
+ */
+async function loadWorkspaceFiles(root, config, log, opts) {
+    const exclude = config?.exclude;
+    const spin = (0, logger_1.createSpinner)('Discovering files…', { quiet: opts?.quiet });
+    const discoveredPaths = await (0, core_1.discoverFiles)(root, exclude ? { exclude } : undefined);
+    if (discoveredPaths.length === 0) {
+        spin.stop('No files found');
+        return {
+            relativeFiles: new Map(),
+            absoluteFiles: new Map(),
+            discoveredPaths: [],
+            host: (0, core_1.createNodeHostForWorkspace)(root),
+        };
+    }
+    spin.stop(`Discovered ${discoveredPaths.length} files`);
+    const spinRead = (0, logger_1.createSpinner)(`Reading ${discoveredPaths.length} files…`, { quiet: opts?.quiet });
+    const relativeFiles = new Map();
+    const absoluteFiles = new Map();
+    for (const abs of discoveredPaths) {
+        const rel = path.relative(root, abs).replace(/\\/g, '/');
+        try {
+            const content = fs.readFileSync(abs, 'utf-8');
+            relativeFiles.set(rel, content);
+            absoluteFiles.set(abs, content);
+        }
+        catch {
+            log.debug(`  skip (unreadable): ${rel}`);
+        }
+    }
+    spinRead.stop(`Read ${relativeFiles.size} files`);
+    return {
+        relativeFiles,
+        absoluteFiles,
+        discoveredPaths,
+        host: (0, core_1.createNodeHostForWorkspace)(root),
+    };
+}
+//# sourceMappingURL=workspace.js.map

package/dist/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCH,gDA0CC;AA3ED,uCAAyB;AACzB,2CAA6B;AAC7B,2CAI0B;AAG1B,qCAAyC;AAazC;;;;;;;;;;GAUG;AACI,KAAK,UAAU,kBAAkB,CACtC,IAAY,EACZ,MAAoC,EACpC,GAAW,EACX,IAA0B;IAE1B,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,CAAC;IAEhC,MAAM,IAAI,GAAG,IAAA,sBAAa,EAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACzE,MAAM,eAAe,GAAG,MAAM,IAAA,oBAAa,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACrF,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC5B,OAAO;YACL,aAAa,EAAE,IAAI,GAAG,EAAE;YACxB,aAAa,EAAE,IAAI,GAAG,EAAE;YACxB,eAAe,EAAE,EAAE;YACnB,IAAI,EAAE,IAAA,iCAA0B,EAAC,IAAI,CAAC;SACvC,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,cAAc,eAAe,CAAC,MAAM,QAAQ,CAAC,CAAC;IAExD,MAAM,QAAQ,GAAG,IAAA,sBAAa,EAAC,WAAW,eAAe,CAAC,MAAM,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACnG,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;IAChD,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;IAChD,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACzD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC9C,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAChC,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC;YACP,GAAG,CAAC,KAAK,CAAC,wBAAwB,GAAG,EAAE,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IACD,QAAQ,CAAC,IAAI,CAAC,QAAQ,aAAa,CAAC,IAAI,QAAQ,CAAC,CAAC;IAElD,OAAO;QACL,aAAa;QACb,aAAa;QACb,eAAe;QACf,IAAI,EAAE,IAAA,iCAA0B,EAAC,IAAI,CAAC;KACvC,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "aspectcode",
+  "version": "0.2.0",
+  "description": "CLI for Aspect Code — generate knowledge-base artifacts from the command line",
+  "license": "MIT",
+  "main": "dist/main.js",
+  "types": "dist/main.d.ts",
+  "bin": {
+    "aspectcode": "bin/aspectcode.js",
+    "aspect": "bin/aspectcode.js"
+  },
+  "files": [
+    "bin",
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "aspectcode",
+    "knowledge-base",
+    "ai",
+    "copilot",
+    "cursor",
+    "claude",
+    "code-analysis",
+    "static-analysis",
+    "dependency-graph"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/asashepard/aspectcode.git",
+    "directory": "packages/cli"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build",
+    "test": "mocha --require ts-node/register 'test/**/*.test.ts'"
+  },
+  "dependencies": {
+    "@aspectcode/core": "0.2.0",
+    "@aspectcode/emitters": "0.2.0",
+    "chokidar": "^4.0.3"
+  },
+  "devDependencies": {
+    "@types/mocha": "^10.0.0",
+    "@types/node": "^22.0.0",
+    "mocha": "^10.4.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.5.4"
+  }
+}