aspectcode 0.4.1 → 1.0.1

package/dist/complaintProcessor.d.ts

@@ -1,16 +0,0 @@
-/**
- * Complaint processor — takes queued user complaints, calls the
- * complaint agent to update AGENTS.md, and reports changes via the store.
- */
-import type { RunContext } from './cli';
-import type { OwnershipMode } from './writer';
-/**
- * Drain the complaint queue and apply each batch of complaints to AGENTS.md.
- *
- * Reads the current AGENTS.md, sends complaints + KB context to the LLM,
- * writes the updated file, and surfaces changes in the dashboard.
- *
- * @returns true if at least one complaint was processed, false otherwise.
- */
-export declare function processComplaints(ctx: RunContext, ownership: OwnershipMode, kbContent: string): Promise<boolean>;
-//# sourceMappingURL=complaintProcessor.d.ts.map

package/dist/complaintProcessor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"complaintProcessor.d.ts","sourceRoot":"","sources":["../src/complaintProcessor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAIxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,UAAU,EACf,SAAS,EAAE,aAAa,EACxB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAmFlB"}

package/dist/complaintProcessor.js

@@ -1,134 +0,0 @@
-"use strict";
-/**
- * Complaint processor — takes queued user complaints, calls the
- * complaint agent to update AGENTS.md, and reports changes via the store.
- */
-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.processComplaints = processComplaints;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const optimizer_1 = require("@aspectcode/optimizer");
-const emitters_1 = require("@aspectcode/emitters");
-const config_1 = require("./config");
-const writer_1 = require("./writer");
-const store_1 = require("./ui/store");
-/**
- * Drain the complaint queue and apply each batch of complaints to AGENTS.md.
- *
- * Reads the current AGENTS.md, sends complaints + KB context to the LLM,
- * writes the updated file, and surfaces changes in the dashboard.
- *
- * @returns true if at least one complaint was processed, false otherwise.
- */
-async function processComplaints(ctx, ownership, kbContent) {
-    const { root, flags, log } = ctx;
-    // ── Collect all queued complaints ─────────────────────────
-    const complaints = [];
-    let next;
-    while ((next = store_1.store.shiftComplaint()) !== undefined) {
-        complaints.push(next);
-    }
-    if (complaints.length === 0)
-        return false;
-    // ── Resolve LLM provider ─────────────────────────────────
-    const config = (0, config_1.loadConfig)(root);
-    const optConfig = config?.optimize;
-    const model = flags.model ?? optConfig?.model;
-    const providerName = flags.provider ?? optConfig?.provider;
-    const maxTokens = optConfig?.maxTokens;
-    const temperature = flags.temperature ?? optConfig?.temperature;
-    let env;
-    try {
-        env = (0, optimizer_1.loadEnvFile)(root);
-    }
-    catch {
-        env = {};
-    }
-    if (providerName && !env['LLM_PROVIDER']) {
-        env['LLM_PROVIDER'] = providerName;
-    }
-    const providerOptions = {};
-    if (model)
-        providerOptions.model = model;
-    if (temperature !== undefined)
-        providerOptions.temperature = temperature;
-    if (maxTokens !== undefined)
-        providerOptions.maxTokens = maxTokens;
-    let provider;
-    try {
-        provider = (0, optimizer_1.resolveProvider)(env, providerOptions);
-    }
-    catch {
-        store_1.store.setWarning('No API key — cannot process complaints.');
-        return false;
-    }
-    // ── Read current AGENTS.md ────────────────────────────────
-    let currentInstructions;
-    try {
-        const agentsPath = path.join(root, 'AGENTS.md');
-        currentInstructions = fs.readFileSync(agentsPath, 'utf-8');
-    }
-    catch {
-        store_1.store.setWarning('AGENTS.md not found — run the pipeline first.');
-        return false;
-    }
-    // ── Run complaint agent ───────────────────────────────────
-    store_1.store.setProcessingComplaint(true);
-    store_1.store.clearComplaintChanges();
-    log.info(`Processing ${complaints.length} complaint${complaints.length === 1 ? '' : 's'}…`);
-    const result = await (0, optimizer_1.runComplaintAgent)({
-        currentInstructions,
-        kb: kbContent,
-        complaints,
-        provider,
-        log: flags.quiet ? undefined : {
-            info: (msg) => log.info(msg),
-            warn: (msg) => log.warn(msg),
-            error: (msg) => log.error(msg),
-            debug: (msg) => log.debug(msg),
-        },
-    });
-    // ── Write updated AGENTS.md ───────────────────────────────
-    if (!flags.dryRun) {
-        const host = (0, emitters_1.createNodeEmitterHost)();
-        await (0, writer_1.writeAgentsMd)(host, root, result.optimizedInstructions, ownership);
-        log.success('AGENTS.md updated from complaints');
-    }
-    store_1.store.setComplaintChanges(result.changes);
-    store_1.store.setProcessingComplaint(false);
-    return true;
-}
-//# sourceMappingURL=complaintProcessor.js.map

package/dist/complaintProcessor.js.map

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

package/node_modules/@aspectcode/emitters/dist/emitter.d.ts

@@ -1,72 +0,0 @@
-/**
- * Emitter interface — the contract for all artifact generators.
- *
- * Each emitter takes an AnalysisModel + options and writes files
- * via the EmitterHost abstraction. Emitters MUST produce deterministic
- * output for the same input (modulo `generatedAt` timestamps).
- */
-import type { AnalysisModel } from '@aspectcode/core';
-import type { EmitterHost } from './host';
-/** Mode for instruction content generation. */
-export type InstructionsMode = 'safe' | 'permissive' | 'custom' | 'off';
-/** Options passed to every emitter. */
-export interface EmitOptions {
-    /** Absolute path to the workspace root. */
-    workspaceRoot: string;
-    /**
-     * Absolute path to the output root where generated artifacts are written.
-     *
-     * Defaults to `workspaceRoot`.
-     *
-     * This allows generating into a temp directory (tests/CLI/GitHub Action)
-     * without depending on CWD or VS Code workspace filesystem roots.
-     */
-    outDir?: string;
-    /**
-     * ISO-8601 timestamp to embed in outputs.
-     * Defaults to `new Date().toISOString()` if omitted.
-     * Pass a fixed value in tests for determinism.
-     */
-    generatedAt?: string;
-    /** Instruction content mode. */
-    instructionsMode?: InstructionsMode;
-    /** Pre-loaded file contents (avoids re-reading from disk). */
-    fileContents?: Map<string, string>;
-    /**
-     * Whether to generate the KB file (`kb.md`).
-     *
-     * Defaults to `false`. When `false`, only instruction files are emitted.
-     * Set to `true` to generate the knowledge base.
-     */
-    generateKb?: boolean;
-    /**
-     * List of output format IDs to emit instruction files for.
-     *
-     * When omitted or empty, only `AGENTS.md` is written (the universal target).
-     * Supported values: 'agents', 'copilot', 'cursor', 'claudeCode',
-     * 'windsurf', 'cline', 'gemini', 'aider', 'amazonq', 'codex'.
-     *
-     * AGENTS.md is always written regardless of this list.
-     */
-    outputFormats?: string[];
-}
-/** Result returned by an emitter after writing artifacts. */
-export interface EmitResult {
-    /** Absolute paths of all files written or updated. */
-    filesWritten: string[];
-}
-/** A named artifact generator. */
-export interface Emitter {
-    /** Human-readable name (e.g. "aspect-kb", "instructions"). */
-    readonly name: string;
-    /**
-     * Generate and write artifacts.
-     *
-     * @param model   The analysis model to consume.
-     * @param host    File I/O abstraction.
-     * @param options Generation options.
-     * @returns       Paths of all files written.
-     */
-    emit(model: AnalysisModel, host: EmitterHost, options: EmitOptions): Promise<EmitResult>;
-}
-//# sourceMappingURL=emitter.d.ts.map

package/node_modules/@aspectcode/emitters/dist/emitter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../src/emitter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAI1C,+CAA+C;AAC/C,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,YAAY,GAAG,QAAQ,GAAG,KAAK,CAAC;AAExE,uCAAuC;AACvC,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAC;IAEtB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,gCAAgC;IAChC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAEpC,8DAA8D;IAC9D,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEnC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAID,6DAA6D;AAC7D,MAAM,WAAW,UAAU;IACzB,sDAAsD;IACtD,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAID,kCAAkC;AAClC,MAAM,WAAW,OAAO;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;;;;OAOG;IACH,IAAI,CACF,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAAC;CACxB"}

package/node_modules/@aspectcode/emitters/dist/emitter.js

@@ -1,10 +0,0 @@
-"use strict";
-/**
- * Emitter interface — the contract for all artifact generators.
- *
- * Each emitter takes an AnalysisModel + options and writes files
- * via the EmitterHost abstraction. Emitters MUST produce deterministic
- * output for the same input (modulo `generatedAt` timestamps).
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=emitter.js.map

package/node_modules/@aspectcode/emitters/dist/emitter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"emitter.js","sourceRoot":"","sources":["../src/emitter.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/node_modules/@aspectcode/emitters/dist/instructions/content.d.ts

@@ -1,26 +0,0 @@
-import type { InstructionsMode } from '../emitter';
-/**
- * Generates the canonical instruction content.
- *
- * When `kbAvailable` is true, the content references the `kb.md` knowledge
- * base file. When false, it provides standalone rules and guidelines only.
- *
- * All assistant-specific exports are derived from this single source.
- */
-export declare function generateCanonicalContentForMode(mode: InstructionsMode, kbAvailable?: boolean): string;
-/**
- * Generate a project-customized AGENTS.md using actual KB content.
- *
- * Extracts key architectural facts (hubs, entry points, conventions, etc.)
- * from the KB string and embeds them directly into the instructions file.
- * This produces a useful, project-specific result even without an LLM.
- *
- * Falls back to the generic KB-aware template if no meaningful sections
- * can be extracted.
- */
-export declare function generateKbCustomContent(kbContent: string, mode?: InstructionsMode): string;
-export declare function generateCanonicalContentSafe(): string;
-export declare function generateCanonicalContentPermissive(): string;
-export declare function generateCanonicalContentSafeKB(): string;
-export declare function generateCanonicalContentPermissiveKB(): string;
-//# sourceMappingURL=content.d.ts.map

package/node_modules/@aspectcode/emitters/dist/instructions/content.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/instructions/content.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAWnD;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,gBAAgB,EACtB,WAAW,UAAQ,GAClB,MAAM,CAOR;AAMD;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,gBAAyB,GAC9B,MAAM,CAiBR;AAqOD,wBAAgB,4BAA4B,IAAI,MAAM,CAsDrD;AAED,wBAAgB,kCAAkC,IAAI,MAAM,CA4C3D;AAMD,wBAAgB,8BAA8B,IAAI,MAAM,CAkGvD;AAED,wBAAgB,oCAAoC,IAAI,MAAM,CAoD7D"}