aspectcode 0.4.0 → 1.0.0

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,15 +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;
-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;AAUnD;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,gBAAgB,EACtB,WAAW,UAAQ,GAClB,MAAM,CAOR;AAMD,wBAAgB,4BAA4B,IAAI,MAAM,CAsDrD;AAED,wBAAgB,kCAAkC,IAAI,MAAM,CA4C3D;AAMD,wBAAgB,8BAA8B,IAAI,MAAM,CAkGvD;AAED,wBAAgB,oCAAoC,IAAI,MAAM,CAoD7D"}

package/node_modules/@aspectcode/emitters/dist/instructions/content.js

@@ -1,289 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateCanonicalContentForMode = generateCanonicalContentForMode;
-exports.generateCanonicalContentSafe = generateCanonicalContentSafe;
-exports.generateCanonicalContentPermissive = generateCanonicalContentPermissive;
-exports.generateCanonicalContentSafeKB = generateCanonicalContentSafeKB;
-exports.generateCanonicalContentPermissiveKB = generateCanonicalContentPermissiveKB;
-// ─────────────────────────────────────────────────────────────────────────────
-// Canonical instruction content - all exports derive from this
-//
-// Two tiers:
-//   1. Rules-only (no KB references) — default when kb.md is not generated
-//   2. KB-aware (references kb.md) — used when generateKb is enabled
-// ─────────────────────────────────────────────────────────────────────────────
-/**
- * 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.
- */
-function generateCanonicalContentForMode(mode, kbAvailable = false) {
-    if (mode === 'permissive') {
-        return kbAvailable
-            ? generateCanonicalContentPermissiveKB()
-            : generateCanonicalContentPermissive();
-    }
-    return kbAvailable ? generateCanonicalContentSafeKB() : generateCanonicalContentSafe();
-}
-// ─────────────────────────────────────────────────────────────────────────────
-// Rules-only content (no KB references)
-// ─────────────────────────────────────────────────────────────────────────────
-function generateCanonicalContentSafe() {
-    return `## Aspect Code — Coding Guidelines
-
-**Aspect Code** provides coding guidelines to help you make safer, more informed code changes.
-
-## Golden Rules
-
-1. **Read before you write.** Open and read the relevant files before multi-file edits.
-2. **Think step-by-step.** Break complex tasks into smaller steps; reason through each before coding.
-3. **Prefer minimal, local changes.** Small patches are safer than large refactors, especially in widely-imported files.
-4. **Never truncate code.** Don't use placeholders like \`// ...rest\` or \`# existing code...\`. Provide complete implementations.
-5. **Don't touch tests, migrations, or third-party code** unless the user explicitly asks you to.
-6. **Never remove referenced logic.** Check all callers before deleting a function, class, or symbol.
-7. **Understand blast radius.** Trace relationships and dependents before refactoring.
-8. **Follow existing naming patterns.** Match the project's existing naming patterns and import styles.
-9. **When unsure, go small.** Propose a minimal, reversible change instead of a sweeping refactor.
-
-## Recommended Workflow
-
-1. **Understand the task.** Parse requirements; note which files or endpoints are involved.
-2. **Find relevant code.** Locate data models, symbols, and naming conventions.
-3. **Understand relationships.** See which files are commonly edited together and how they connect.
-4. **Trace impact.** Review callers and dependents to gauge the blast radius of changes.
-5. **Gather evidence.** If behavior is unclear, add targeted logging or traces to confirm assumptions.
-6. **Make minimal edits.** Implement the smallest change that solves the task; run tests.
-
-## When Changing Code
-
-- **Read the COMPLETE file** before modifying it. Preserve all existing exports/functions.
-- **Add, don't reorganize.** Unless the task says "refactor", avoid moving code around.
-- **Check widely-imported files** before editing them — changes ripple to all dependents.
-- **Avoid renaming** widely-used symbols without updating all callers.
-- **No new dependency cycles.** Before adding an import, verify it won't create a circular dependency.
-- **Match conventions.** Follow existing naming patterns (naming, imports, frameworks).
-- **Prefer small, localized changes** in the most relevant module.
-
-## When Things Go Wrong
-
-If you encounter repeated errors or unexpected behavior:
-
-1. **Use git** to see what changed: \`git diff\`, \`git status\`
-2. **Restore lost code** with \`git checkout -- <file>\` if needed
-3. **Re-read the complete file** before making more changes
-4. **Trace data flows** to understand execution paths
-5. **Run actual tests** to verify behavior before assuming something works
-
-## General Guidelines
-
-- **Start with the most relevant file.** Understand the area before changing it.
-- **Check widely-imported modules.** Know which files have many dependents before editing.
-- **Follow existing conventions.** Match existing naming patterns and coding styles exactly.
-- **Minimal changes.** Make the smallest change that solves the problem correctly.
-- **Acknowledge risk.** If editing a widely-imported file, note the elevated risk.
-`.trim();
-}
-function generateCanonicalContentPermissive() {
-    return `## Aspect Code — Coding Guidelines
-
-**Aspect Code** provides coding guidelines to help you make informed code changes.
-
-Use these guidelines as orientation — not as constraints.
-
-### Operating Rules (Pragmatic, Not Rigid)
-
-- Read relevant code before large edits; understand boundaries, flows, and ownership
-- If your change creates a conflict with existing structure, either:
-  - update the code in a way that keeps the existing intent valid, or
-  - explicitly state the mismatch and proceed with a coherent new structure
-
-### You May (Explicitly Allowed)
-
-- Refactor for clarity: extract functions, split files, consolidate duplicates
-- Reorganize modules/folders when it improves cohesion and discoverability
-- Touch multiple files when the change is conceptually one improvement
-- Change public/internal APIs when it simplifies the design (with follow-through updates)
-- Rename symbols for consistency (types, functions, modules) and update references
-
-### You Should
-
-- Explain the new structure in terms of the existing architecture
-- Keep changes "conceptually tight": one goal, end-to-end, fully wired
-- Update call sites and imports immediately when you move/rename things
-- Prefer simplification over novelty; remove unnecessary layers when justified
-- Validate that referenced symbols still exist and are still reachable from call sites
-
-### Avoid
-
-- Deleting or renaming referenced symbols without updating all usages
-- Unnecessary scope creep (adding features unrelated to the request)
-- Blind rewrites that ignore the project's dependency structure and entry points
-- "Rebuild everything" refactors when a targeted restructure achieves the goal
-- Cosmetic churn that obscures meaningful changes
-
-## Suggested Workflow
-
-1. Read the relevant code for orientation.
-2. Implement the change end-to-end.
-3. Run tests / build.
-`.trim();
-}
-// ─────────────────────────────────────────────────────────────────────────────
-// KB-aware content (references kb.md)
-// ─────────────────────────────────────────────────────────────────────────────
-function generateCanonicalContentSafeKB() {
-    return `## Aspect Code Knowledge Base
-
-**Aspect Code** is a static-analysis tool that generates a Knowledge Base (KB) for your codebase. The KB is in \`kb.md\` at the workspace root and contains these sections:
-
-| Section | Purpose |
-|---------|---------|
-| **Architecture** | **Read first.** High-risk hubs, directory layout, entry points—the "Do Not Break" zones |
-| **Map** | Data models with signatures, symbol index, naming conventions |
-| **Context** | Module clusters (co-edited files), external integrations, data flow paths |
-
-**Key architectural intelligence:**
-- **High-Risk Hubs** in the Architecture section: Files with many dependents—changes here ripple widely
-- **Entry Points** in the Architecture section: HTTP handlers, CLI commands, event listeners
-- **External Integrations** in the Context section: API clients, database connections, message queues
-- **Data Models** in the Map section: ORM models, dataclasses, TypeScript interfaces with signatures
-
-Read the relevant sections of \`kb.md\` **before** making multi-file changes.
-
-## Golden Rules
-
-1. **Read the KB as a map, not a checklist.** Use \`kb.md\` to understand architecture, not as a to-do list.
-2. **Read before you write.** Open the relevant KB sections before multi-file edits.
-3. **Check architecture first.** Review the Architecture section to understand high-risk zones before coding.
-4. **Think step-by-step.** Break complex tasks into smaller steps; reason through each before coding.
-5. **Prefer minimal, local changes.** Small patches are safer than large refactors, especially in hub files.
-6. **Never truncate code.** Don't use placeholders like \`// ...rest\` or \`# existing code...\`. Provide complete implementations.
-7. **Don't touch tests, migrations, or third-party code** unless the user explicitly asks you to.
-8. **Never remove referenced logic.** If a symbol appears in the Map section, check all callers before deleting.
-9. **Understand blast radius.** Use the Context and Map sections to trace relationships before refactors.
-10. **Follow naming patterns in the Map section.** Match the project's existing naming patterns and import styles.
-11. **When unsure, go small.** Propose a minimal, reversible change instead of a sweeping refactor.
-
-## Recommended Workflow
-
-1. **Understand the task.** Parse requirements; note which files or endpoints are involved.
-2. **Check architecture.** Open \`kb.md\` → review the Architecture section for high-risk hubs and entry points.
-3. **Find relevant code.** Review the Map section → locate data models, symbols, and naming conventions.
-4. **Understand relationships.** Review the Context section → see module clusters (co-edited files) and integrations.
-5. **Trace impact.** Review "Called by" in the Map section to gauge the blast radius of changes.
-6. **Gather evidence.** If behavior is unclear, add targeted logging or traces to confirm assumptions.
-7. **Make minimal edits.** Implement the smallest change that solves the task; run tests.
-
-## When Changing Code
-
-- **Read the COMPLETE file** before modifying it. Preserve all existing exports/functions.
-- **Add, don't reorganize.** Unless the task says "refactor", avoid moving code around.
-- **Check high-risk hubs** (Architecture section) before editing widely-imported files.
-- **Avoid renaming** widely-used symbols listed in the Map section without updating all callers.
-- **No new cycles.** Before adding an import, verify it won't create a circular dependency (Architecture section).
-- **Match conventions.** Follow naming patterns shown in the Map section (naming, imports, frameworks).
-- **Check module clusters** (Context section) to understand which files are commonly edited together.
-- **Prefer small, localized changes** in the most relevant app module identified by the KB.
-- **Use the Architecture, Map, and Context sections** to locate the smallest, safest place to make a change.
-
-## How to Use kb.md
-
-| Section | When to Open | What to Look For |
-|---------|--------------|------------------|
-| Architecture | **First, always** | High-risk hubs, directory layout, entry points, circular dependencies |
-| Map | Before modifying a function | Data models with signatures, symbol index, naming conventions |
-| Context | Before architectural changes | Module clusters, external integrations, data flow patterns |
-
-### Quick Reference
-
-- **High-risk hubs** → Files with 3+ dependents listed in the Architecture section—changes ripple widely
-- **Entry points** → HTTP handlers, CLI commands, event listeners in the Architecture section
-- **External integrations** → HTTP clients, DB connections, message queues in the Context section
-- **Data models** → ORM models, dataclasses, interfaces with signatures in the Map section
-- **Module clusters** → Files commonly edited together in the Context section
-- **High-impact symbol** → 5+ callers in the Map section "Called by" column
-
-## When Things Go Wrong
-
-If you encounter repeated errors or unexpected behavior:
-
-1. **Use git** to see what changed: \`git diff\`, \`git status\`
-2. **Restore lost code** with \`git checkout -- <file>\` if needed
-3. **Re-read the complete file** before making more changes
-4. **Trace data flows** using the Context section to understand execution paths
-5. **Run actual tests** to verify behavior before assuming something works
-6. **Check module clusters** in the Context section for related files that may need updates
-
-## General Guidelines
-
-- **Read kb.md first.** Before making changes, consult the relevant knowledge base sections.
-- **Start with the Architecture section.** Understand high-risk hubs and entry points.
-- **Check hub modules.** Know which files have many dependents before editing.
-- **Follow Map section conventions.** Match existing naming patterns and coding styles exactly.
-- **Minimal changes.** Make the smallest change that solves the problem correctly.
-- **Acknowledge risk.** If editing a hub module or high-impact file, note the elevated risk.
-
-## Section Headers (Pattern-Matching)
-
-**Architecture:** \`## High-Risk Architectural Hubs\`, \`## Directory Layout\`, \`## Entry Points\`, \`## Circular Dependencies\`
-**Map:** \`## Data Models\` (with signatures), \`## Symbol Index\` (with Called By), \`## Conventions\`
-**Context:** \`## Module Clusters\` (co-edited files), \`## External Integrations\`, \`## Critical Flows\`
-`.trim();
-}
-function generateCanonicalContentPermissiveKB() {
-    return `## Aspect Code Knowledge Base
-
-**Aspect Code** is a static-analysis tool that generates a Knowledge Base (KB) for your codebase. The KB is in \`kb.md\` at the workspace root and contains these sections:
-
-| Section | Purpose |
-|---------|---------|
-| **Architecture** | Hubs, directory layout, entry points |
-| **Map** | Data models with signatures, symbol index, naming conventions |
-| **Context** | Module clusters (co-edited files), external integrations, data flow paths |
-
-Use the Knowledge Base (KB) as orientation and ground truth for architecture and dependencies—not as a constraint.
-
-### Operating Rules (KB-First, Not KB-Locked)
-
-- Read \`kb.md\` before large edits; use it to understand boundaries, flows, and ownership
-- Treat the KB as the source of "what connects to what" (entry points, hubs, key types)
-- If your change conflicts with the KB, either:
-  - update the code in a way that keeps the KB's intent valid, or
-  - explicitly state the mismatch and proceed with a coherent new structure
-
-### You May (Explicitly Allowed)
-
-- Refactor for clarity: extract functions, split files, consolidate duplicates
-- Reorganize modules/folders when it improves cohesion and discoverability
-- Touch multiple files when the change is conceptually one improvement
-- Change public/internal APIs when it simplifies the design (with follow-through updates)
-- Edit high-risk hubs when needed—do it deliberately, with dependency awareness
-- Rename symbols for consistency (types, functions, modules) and update references
-
-### You Should
-
-- Explain the new structure in terms of the existing architecture
-- Keep changes "conceptually tight": one goal, end-to-end, fully wired
-- Update call sites and imports immediately when you move/rename things
-- Prefer simplification over novelty; remove unnecessary layers when justified
-- Validate that referenced symbols still exist and are still reachable from call sites
-
-### Avoid
-
-- Deleting or renaming referenced symbols without updating all usages
-- Unnecessary scope creep (adding features unrelated to the request)
-- Blind rewrites that ignore \`kb.md\`'s dependency map and entry points
-- "Rebuild everything" refactors when a targeted restructure achieves the goal
-- Cosmetic churn that obscures meaningful changes
-
-## Suggested Workflow
-
-1. Skim the relevant sections of \`kb.md\` for orientation.
-2. Implement the change end-to-end.
-3. Run tests / build.
-`.trim();
-}
-//# sourceMappingURL=content.js.map

package/node_modules/@aspectcode/emitters/dist/instructions/content.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"content.js","sourceRoot":"","sources":["../../src/instructions/content.ts"],"names":[],"mappings":";;AAkBA,0EAUC;AAMD,oEAsDC;AAED,gFA4CC;AAMD,wEAkGC;AAED,oFAoDC;AAlSD,gFAAgF;AAChF,+DAA+D;AAC/D,EAAE;AACF,aAAa;AACb,2EAA2E;AAC3E,qEAAqE;AACrE,gFAAgF;AAEhF;;;;;;;GAOG;AACH,SAAgB,+BAA+B,CAC7C,IAAsB,EACtB,WAAW,GAAG,KAAK;IAEnB,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;QAC1B,OAAO,WAAW;YAChB,CAAC,CAAC,oCAAoC,EAAE;YACxC,CAAC,CAAC,kCAAkC,EAAE,CAAC;IAC3C,CAAC;IACD,OAAO,WAAW,CAAC,CAAC,CAAC,8BAA8B,EAAE,CAAC,CAAC,CAAC,4BAA4B,EAAE,CAAC;AACzF,CAAC;AAED,gFAAgF;AAChF,wCAAwC;AACxC,gFAAgF;AAEhF,SAAgB,4BAA4B;IAC1C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoDR,CAAC,IAAI,EAAE,CAAC;AACT,CAAC;AAED,SAAgB,kCAAkC;IAChD,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0CR,CAAC,IAAI,EAAE,CAAC;AACT,CAAC;AAED,gFAAgF;AAChF,sCAAsC;AACtC,gFAAgF;AAEhF,SAAgB,8BAA8B;IAC5C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgGR,CAAC,IAAI,EAAE,CAAC;AACT,CAAC;AAED,SAAgB,oCAAoC;IAClD,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkDR,CAAC,IAAI,EAAE,CAAC;AACT,CAAC"}

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

@@ -1,13 +0,0 @@
-import type { EmitterHost } from '../host';
-import type { AiToolId } from './formats';
-export type AssistantId = 'aspectKB' | 'agentsMd';
-/**
- * Detects which Aspect Code artifacts exist (KB, instructions).
- */
-export declare function detectAssistants(host: EmitterHost, workspaceRoot: string): Promise<Set<AssistantId>>;
-/**
- * Detects which AI coding tools are present in the workspace by checking
- * for their config/instruction files on disk.
- */
-export declare function detectAiTools(host: EmitterHost, workspaceRoot: string): Promise<Set<AiToolId>>;
-//# sourceMappingURL=detection.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"detection.d.ts","sourceRoot":"","sources":["../../src/instructions/detection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAK1C,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,UAAU,CAAC;AAOlD;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,WAAW,EACjB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAuB3B;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,WAAW,EACjB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAuBxB"}

package/node_modules/@aspectcode/emitters/dist/instructions/detection.js

@@ -1,55 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.detectAssistants = detectAssistants;
-exports.detectAiTools = detectAiTools;
-const formats_1 = require("./formats");
-const ASSISTANT_DETECTION_PATHS = [
-    { id: 'aspectKB', paths: ['.aspect'] },
-    { id: 'agentsMd', paths: ['AGENTS.md'] },
-];
-/**
- * Detects which Aspect Code artifacts exist (KB, instructions).
- */
-async function detectAssistants(host, workspaceRoot) {
-    const detected = new Set();
-    const allPromises = ASSISTANT_DETECTION_PATHS.flatMap((check) => check.paths.map(async (p) => {
-        const abs = host.join(workspaceRoot, p);
-        try {
-            return (await host.exists(abs)) ? check.id : null;
-        }
-        catch {
-            return null;
-        }
-    }));
-    const results = await Promise.allSettled(allPromises);
-    for (const result of results) {
-        if (result.status === 'fulfilled' && result.value) {
-            detected.add(result.value);
-        }
-    }
-    return detected;
-}
-/**
- * Detects which AI coding tools are present in the workspace by checking
- * for their config/instruction files on disk.
- */
-async function detectAiTools(host, workspaceRoot) {
-    const detected = new Set();
-    const allPromises = formats_1.AI_TOOL_DETECTION_PATHS.flatMap((check) => check.paths.map(async (p) => {
-        const abs = host.join(workspaceRoot, p);
-        try {
-            return (await host.exists(abs)) ? check.id : null;
-        }
-        catch {
-            return null;
-        }
-    }));
-    const results = await Promise.allSettled(allPromises);
-    for (const result of results) {
-        if (result.status === 'fulfilled' && result.value) {
-            detected.add(result.value);
-        }
-    }
-    return detected;
-}
-//# sourceMappingURL=detection.js.map

package/node_modules/@aspectcode/emitters/dist/instructions/detection.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"detection.js","sourceRoot":"","sources":["../../src/instructions/detection.ts"],"names":[],"mappings":";;AAgBA,4CA0BC;AAMD,sCA0BC;AAxED,uCAAoD;AAMpD,MAAM,yBAAyB,GAAwD;IACrF,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE;IACtC,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,WAAW,CAAC,EAAE;CACzC,CAAC;AAEF;;GAEG;AACI,KAAK,UAAU,gBAAgB,CACpC,IAAiB,EACjB,aAAqB;IAErB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAe,CAAC;IAExC,MAAM,WAAW,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAC9D,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,CAAC,CACH,CAAC;IAEF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IAEtD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAClD,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,aAAa,CACjC,IAAiB,EACjB,aAAqB;IAErB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAY,CAAC;IAErC,MAAM,WAAW,GAAG,iCAAuB,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAC5D,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,CAAC,CACH,CAAC;IAEF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IAEtD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAClD,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

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

@@ -1,9 +0,0 @@
-/**
- * Instructions emitter — writes AGENTS.md with full-file ownership.
- *
- * No markers, no merge logic. The entire file is owned by AspectCode.
- * Content comes from the static generator or from the optimizer.
- */
-import type { Emitter } from '../emitter';
-export declare function createInstructionsEmitter(): Emitter;
-//# sourceMappingURL=instructionsEmitter.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"instructionsEmitter.d.ts","sourceRoot":"","sources":["../../src/instructions/instructionsEmitter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,OAAO,EAA2B,MAAM,YAAY,CAAC;AAInE,wBAAgB,yBAAyB,IAAI,OAAO,CAuBnD"}