engineering-intelligence 0.2.0

package/dist/installer/index.js

@@ -0,0 +1,206 @@
+import { access, mkdir, readFile, unlink, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { renderAdapters } from "../adapters/index.js";
+import { MANIFEST_PATH, TEMPLATE_VERSION, hashContent, readManifest, writeManifest } from "../manifest/index.js";
+import { validateRender } from "../validation/index.js";
+import { readManagedBlock, removeManagedBlock, upsertManagedBlock } from "./blocks.js";
+async function exists(location) {
+    try {
+        await access(location);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function readMaybe(location) {
+    try {
+        return await readFile(location, "utf8");
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return undefined;
+        }
+        throw error;
+    }
+}
+async function writeTarget(root, relativePath, content) {
+    const absolute = path.join(root, relativePath);
+    await mkdir(path.dirname(absolute), { recursive: true });
+    await writeFile(absolute, content, "utf8");
+}
+function priorByPath(manifest) {
+    return new Map((manifest?.files ?? []).map((entry) => [entry.path, entry]));
+}
+function entryFor(rendered) {
+    return {
+        path: rendered.path,
+        kind: rendered.kind,
+        hash: hashContent(rendered.content.trimEnd()),
+        blockId: rendered.blockId,
+        owners: rendered.owners,
+    };
+}
+async function applyRendered(root, rendered, prior, options) {
+    const absolute = path.join(root, rendered.path);
+    const current = await readMaybe(absolute);
+    const desiredEntry = entryFor(rendered);
+    if (rendered.kind === "file") {
+        const currentHash = current === undefined ? undefined : hashContent(current.trimEnd());
+        const isSafe = current === undefined ||
+            currentHash === desiredEntry.hash ||
+            (prior !== undefined && currentHash === prior.hash) ||
+            options.force === true;
+        if (!isSafe) {
+            return {
+                action: { path: rendered.path, status: "conflict", message: "Existing or locally modified file preserved." },
+                entry: prior,
+            };
+        }
+        const status = current === undefined ? "created" : currentHash === desiredEntry.hash ? "unchanged" : "updated";
+        if (!options.dryRun && status !== "unchanged") {
+            await writeTarget(root, rendered.path, rendered.content);
+        }
+        return { action: { path: rendered.path, status }, entry: desiredEntry };
+    }
+    const id = rendered.blockId;
+    const existingBlock = current === undefined ? undefined : readManagedBlock(current, id);
+    const existingHash = existingBlock === undefined ? undefined : hashContent(existingBlock.trimEnd());
+    const isSafe = existingBlock === undefined ||
+        existingHash === desiredEntry.hash ||
+        (prior !== undefined && existingHash === prior.hash) ||
+        options.force === true;
+    if (!isSafe) {
+        return {
+            action: { path: rendered.path, status: "conflict", message: "Locally modified managed block preserved." },
+            entry: prior,
+        };
+    }
+    const status = current === undefined || existingBlock === undefined
+        ? "created"
+        : existingHash === desiredEntry.hash
+            ? "unchanged"
+            : "updated";
+    if (!options.dryRun && status !== "unchanged") {
+        await writeTarget(root, rendered.path, upsertManagedBlock(current ?? "", rendered.content, id));
+    }
+    return { action: { path: rendered.path, status }, entry: desiredEntry };
+}
+async function removeEntry(root, entry, options, reason = "Locally modified content preserved.") {
+    const absolute = path.join(root, entry.path);
+    const current = await readMaybe(absolute);
+    if (current === undefined) {
+        return { action: { path: entry.path, status: "preserved", message: "Already missing." }, retained: false };
+    }
+    const managed = entry.kind === "block" && entry.blockId ? readManagedBlock(current, entry.blockId) : current;
+    const unchanged = managed !== undefined && hashContent(managed.trimEnd()) === entry.hash;
+    if (!unchanged && !options.force) {
+        return { action: { path: entry.path, status: "conflict", message: reason }, retained: true };
+    }
+    if (!options.dryRun) {
+        if (entry.kind === "file") {
+            await unlink(absolute);
+        }
+        else {
+            const remaining = removeManagedBlock(current, entry.blockId);
+            if (remaining.trim().length === 0) {
+                await unlink(absolute);
+            }
+            else {
+                await writeFile(absolute, remaining, "utf8");
+            }
+        }
+    }
+    return { action: { path: entry.path, status: "removed" }, retained: false };
+}
+export async function install(root, requestedAdapters, options) {
+    const priorManifest = await readManifest(root);
+    const adapters = [...new Set([...(priorManifest?.adapters ?? []), ...requestedAdapters])];
+    const errors = await validateRender(adapters);
+    if (errors.length > 0) {
+        return {
+            actions: errors.map((message) => ({ path: "templates", status: "error", message })),
+            conflicts: errors.length,
+            changed: 0,
+        };
+    }
+    const desired = await renderAdapters(adapters);
+    const prior = priorByPath(priorManifest);
+    const actions = [];
+    const entries = [];
+    for (const rendered of desired) {
+        const result = await applyRendered(root, rendered, prior.get(rendered.path), options);
+        actions.push(result.action);
+        if (result.entry) {
+            entries.push(result.entry);
+        }
+    }
+    const desiredPaths = new Set(desired.map((item) => item.path));
+    for (const obsolete of priorManifest?.files ?? []) {
+        if (desiredPaths.has(obsolete.path)) {
+            continue;
+        }
+        const removal = await removeEntry(root, obsolete, options, "Obsolete managed content was edited locally and was preserved.");
+        actions.push(removal.action);
+        if (removal.retained) {
+            entries.push(obsolete);
+        }
+    }
+    const now = new Date().toISOString();
+    const manifest = {
+        schemaVersion: 1,
+        packageVersion: options.packageVersion,
+        templateVersion: TEMPLATE_VERSION,
+        adapters,
+        files: entries,
+        installedAt: priorManifest?.installedAt ?? now,
+        updatedAt: now,
+    };
+    if (!options.dryRun) {
+        await mkdir(path.join(root, ".engineering-intelligence"), { recursive: true });
+        await writeManifest(root, manifest);
+    }
+    return summarize(actions);
+}
+export async function update(root, options) {
+    const manifest = await readManifest(root);
+    if (!manifest) {
+        return summarize([{ path: MANIFEST_PATH, status: "error", message: "Nothing installed; run install first." }]);
+    }
+    return install(root, manifest.adapters, options);
+}
+export async function uninstall(root, options) {
+    const manifest = await readManifest(root);
+    if (!manifest) {
+        return summarize([{ path: MANIFEST_PATH, status: "error", message: "Nothing installed." }]);
+    }
+    const actions = [];
+    const retained = [];
+    for (const entry of manifest.files) {
+        const removal = await removeEntry(root, entry, options);
+        actions.push(removal.action);
+        if (removal.retained) {
+            retained.push(entry);
+        }
+    }
+    if (!options.dryRun) {
+        const manifestAbsolute = path.join(root, MANIFEST_PATH);
+        if (retained.length === 0) {
+            if (await exists(manifestAbsolute)) {
+                await unlink(manifestAbsolute);
+            }
+        }
+        else {
+            await writeManifest(root, { ...manifest, files: retained, updatedAt: new Date().toISOString() });
+        }
+    }
+    return summarize(actions);
+}
+function summarize(actions) {
+    return {
+        actions,
+        conflicts: actions.filter((action) => action.status === "conflict" || action.status === "error").length,
+        changed: actions.filter((action) => ["created", "updated", "removed"].includes(action.status)).length,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/installer/index.js.map

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

package/dist/manifest/index.d.ts

@@ -0,0 +1,7 @@
+import type { InstallManifest } from "../types.js";
+export declare const MANIFEST_PATH = ".engineering-intelligence/install-manifest.json";
+export declare const TEMPLATE_VERSION = "2.0.0";
+export declare function hashContent(content: string): string;
+export declare function readManifest(root: string): Promise<InstallManifest | undefined>;
+export declare function writeManifest(root: string, manifest: InstallManifest): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/manifest/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/manifest/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,aAAa,oDAAoD,CAAC;AAC/E,eAAO,MAAM,gBAAgB,UAAU,CAAC;AAExC,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAWrF;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1F"}

package/dist/manifest/index.js

@@ -0,0 +1,25 @@
+import { createHash } from "node:crypto";
+import { readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+export const MANIFEST_PATH = ".engineering-intelligence/install-manifest.json";
+export const TEMPLATE_VERSION = "2.0.0";
+export function hashContent(content) {
+    return createHash("sha256").update(content).digest("hex");
+}
+export async function readManifest(root) {
+    try {
+        const text = await readFile(path.join(root, MANIFEST_PATH), "utf8");
+        return JSON.parse(text);
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === "ENOENT") {
+            return undefined;
+        }
+        throw error;
+    }
+}
+export async function writeManifest(root, manifest) {
+    await writeFile(path.join(root, MANIFEST_PATH), `${JSON.stringify(manifest, null, 2)}\n`, "utf8");
+}
+//# sourceMappingURL=index.js.map

package/dist/manifest/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/manifest/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,CAAC,MAAM,aAAa,GAAG,iDAAiD,CAAC;AAC/E,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAExC,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY;IAC7C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAoB,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,CAAC;QACnD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,QAAyB;IACzE,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACpG,CAAC"}

package/dist/templates.d.ts

@@ -0,0 +1,6 @@
+export declare const SKILL_NAMES: readonly ["initialize-engineering-intelligence", "engineering-intelligence", "deep-project-knowledge-extractor", "knowledge-base-validator", "impact-analysis-engine", "testing-intelligence-engine", "knowledge-sync-engine", "memory-sync-engine", "context-sync-engine", "change-history-engine", "architecture-review-engine", "refactoring-planner", "graph-engine", "change-detection-engine", "incremental-sync-engine", "engineering-change-review"];
+export declare const AGENT_NAMES: readonly ["engineering-orchestrator", "change-agent", "quality-agent", "knowledge-agent"];
+export declare const WORKFLOW_NAMES: readonly ["initialize-engineering-intelligence", "engineering-intelligence", "map-architecture", "analyze-impact", "sync-engineering-intelligence", "review-engineering-change"];
+export declare function readTemplate(category: "skills" | "agents" | "workflows" | "rules", name: string): Promise<string>;
+export declare function validateCanonicalTemplates(): Promise<string[]>;
+//# sourceMappingURL=templates.d.ts.map

package/dist/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,WAAW,8bAiBd,CAAC;AAEX,eAAO,MAAM,WAAW,2FAKd,CAAC;AAEX,eAAO,MAAM,cAAc,kLAOjB,CAAC;AAOX,wBAAsB,YAAY,CAChC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,EACrD,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAsDpE"}

package/dist/templates.js

@@ -0,0 +1,103 @@
+import { readdir, readFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+export const SKILL_NAMES = [
+    "initialize-engineering-intelligence",
+    "engineering-intelligence",
+    "deep-project-knowledge-extractor",
+    "knowledge-base-validator",
+    "impact-analysis-engine",
+    "testing-intelligence-engine",
+    "knowledge-sync-engine",
+    "memory-sync-engine",
+    "context-sync-engine",
+    "change-history-engine",
+    "architecture-review-engine",
+    "refactoring-planner",
+    "graph-engine",
+    "change-detection-engine",
+    "incremental-sync-engine",
+    "engineering-change-review",
+];
+export const AGENT_NAMES = [
+    "engineering-orchestrator",
+    "change-agent",
+    "quality-agent",
+    "knowledge-agent",
+];
+export const WORKFLOW_NAMES = [
+    "initialize-engineering-intelligence",
+    "engineering-intelligence",
+    "map-architecture",
+    "analyze-impact",
+    "sync-engineering-intelligence",
+    "review-engineering-change",
+];
+function templateRoot() {
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    return path.resolve(here, "../templates/canonical");
+}
+export async function readTemplate(category, name) {
+    const suffix = category === "skills" ? "SKILL.md" : `${name}.md`;
+    const location = category === "skills"
+        ? path.join(templateRoot(), category, name, suffix)
+        : path.join(templateRoot(), category, suffix);
+    return readFile(location, "utf8");
+}
+export async function validateCanonicalTemplates() {
+    const errors = [];
+    const required = [
+        ...SKILL_NAMES.map((name) => ["skills", name]),
+        ...AGENT_NAMES.map((name) => ["agents", name]),
+        ...WORKFLOW_NAMES.map((name) => ["workflows", name]),
+        ["rules", "engineering-intelligence"],
+    ];
+    for (const [category, name] of required) {
+        try {
+            const content = await readTemplate(category, name);
+            if (content.includes(".agent/") || content.includes(".agents/memory") || content.includes(".agents/context")) {
+                errors.push(`${category}/${name} contains an obsolete runtime path`);
+            }
+        }
+        catch {
+            errors.push(`Missing canonical template: ${category}/${name}`);
+        }
+    }
+    const skillDirectory = path.join(templateRoot(), "skills");
+    const foundSkills = await readdir(skillDirectory).catch(() => []);
+    for (const name of SKILL_NAMES) {
+        if (!foundSkills.includes(name)) {
+            errors.push(`Missing canonical skill directory: ${name}`);
+        }
+    }
+    const graph = await readTemplate("skills", "graph-engine").catch(() => "");
+    for (const artifact of [
+        "dependency-graph.json",
+        "service-graph.json",
+        "runtime-graph.json",
+        "business-flow-graph.json",
+        "architecture-map.md",
+    ]) {
+        if (!graph.includes(artifact)) {
+            errors.push(`graph-engine does not define required graph artifact: ${artifact}`);
+        }
+    }
+    for (const requiredContract of ["schemaVersion", "evidence", "unknowns", "verified | inferred | unknown"]) {
+        if (!graph.includes(requiredContract)) {
+            errors.push(`graph-engine does not define required graph contract field: ${requiredContract}`);
+        }
+    }
+    for (const workflow of [
+        "map-architecture",
+        "analyze-impact",
+        "sync-engineering-intelligence",
+        "review-engineering-change",
+    ]) {
+        const content = await readTemplate("workflows", workflow).catch(() => "");
+        if (!content.toLowerCase().includes("not modify product code")) {
+            errors.push(`${workflow} must state that it does not modify product code`);
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=templates.js.map

package/dist/templates.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,38 @@
+export declare const IDE_IDS: readonly ["antigravity", "codex", "claude-code", "cursor", "github-copilot", "gemini-cli", "generic"];
+export type IdeId = (typeof IDE_IDS)[number];
+export type ManagedKind = "file" | "block";
+export interface RenderedFile {
+    path: string;
+    content: string;
+    kind: ManagedKind;
+    blockId?: string;
+    owners: IdeId[];
+}
+export interface ManagedFileEntry {
+    path: string;
+    kind: ManagedKind;
+    hash: string;
+    blockId?: string;
+    owners: IdeId[];
+}
+export interface InstallManifest {
+    schemaVersion: 1;
+    packageVersion: string;
+    templateVersion: string;
+    adapters: IdeId[];
+    files: ManagedFileEntry[];
+    installedAt: string;
+    updatedAt: string;
+}
+export type ActionStatus = "created" | "updated" | "unchanged" | "removed" | "preserved" | "conflict" | "warning" | "error";
+export interface FileAction {
+    path: string;
+    status: ActionStatus;
+    message?: string;
+}
+export interface OperationResult {
+    actions: FileAction[];
+    conflicts: number;
+    changed: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,uGAQV,CAAC;AAEX,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7C,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,CAAC,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,KAAK,EAAE,CAAC;IAClB,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,SAAS,GACT,WAAW,GACX,SAAS,GACT,WAAW,GACX,UAAU,GACV,SAAS,GACT,OAAO,CAAC;AAEZ,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/types.js

@@ -0,0 +1,10 @@
+export const IDE_IDS = [
+    "antigravity",
+    "codex",
+    "claude-code",
+    "cursor",
+    "github-copilot",
+    "gemini-cli",
+    "generic",
+];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,aAAa;IACb,OAAO;IACP,aAAa;IACb,QAAQ;IACR,gBAAgB;IAChB,YAAY;IACZ,SAAS;CACD,CAAC"}

package/dist/validation/index.d.ts

@@ -0,0 +1,4 @@
+import type { FileAction, IdeId } from "../types.js";
+export declare function validateRender(ides: IdeId[]): Promise<string[]>;
+export declare function doctor(root: string): Promise<FileAction[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAWrD,wBAAsB,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsBrE;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAsChE"}

package/dist/validation/index.js

@@ -0,0 +1,77 @@
+import { access, readFile } from "node:fs/promises";
+import path from "node:path";
+import { renderAdapters } from "../adapters/index.js";
+import { readManagedBlock } from "../installer/blocks.js";
+import { MANIFEST_PATH, hashContent, readManifest } from "../manifest/index.js";
+import { validateCanonicalTemplates } from "../templates.js";
+async function exists(location) {
+    try {
+        await access(location);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function validateRender(ides) {
+    const errors = await validateCanonicalTemplates();
+    const rendered = await renderAdapters(ides);
+    for (const item of rendered) {
+        if (item.content.includes(".agent/") ||
+            item.content.includes(".agents/memory") ||
+            item.content.includes(".agents/context")) {
+            errors.push(`${item.path} references an obsolete or host-bound runtime output path`);
+        }
+    }
+    const allContent = rendered.map((item) => item.content).join("\n");
+    for (const requiredPath of [
+        ".engineering-intelligence/graph/",
+        ".engineering-intelligence/reports/",
+    ]) {
+        if (!allContent.includes(requiredPath)) {
+            errors.push(`Rendered templates do not describe required V2 runtime path: ${requiredPath}`);
+        }
+    }
+    return errors;
+}
+export async function doctor(root) {
+    const actions = [];
+    const manifest = await readManifest(root);
+    if (!manifest) {
+        actions.push({ path: MANIFEST_PATH, status: "error", message: "No installation manifest found." });
+        return actions;
+    }
+    const renderingErrors = await validateRender(manifest.adapters);
+    for (const message of renderingErrors) {
+        actions.push({ path: "templates", status: "error", message });
+    }
+    if (await exists(path.join(root, ".agent"))) {
+        actions.push({
+            path: ".agent",
+            status: "warning",
+            message: "Legacy .agent directory found; installed adapters use .agents.",
+        });
+    }
+    for (const entry of manifest.files) {
+        const absolute = path.join(root, entry.path);
+        if (!(await exists(absolute))) {
+            actions.push({ path: entry.path, status: "error", message: "Managed file is missing." });
+            continue;
+        }
+        const current = await readFile(absolute, "utf8");
+        const tracked = entry.kind === "block" && entry.blockId
+            ? readManagedBlock(current, entry.blockId)
+            : current;
+        if (tracked === undefined) {
+            actions.push({ path: entry.path, status: "error", message: "Managed block is missing." });
+        }
+        else if (hashContent(tracked.trimEnd()) !== entry.hash) {
+            actions.push({ path: entry.path, status: "warning", message: "Managed content was edited locally." });
+        }
+        else {
+            actions.push({ path: entry.path, status: "unchanged" });
+        }
+    }
+    return actions;
+}
+//# sourceMappingURL=index.js.map

package/dist/validation/index.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "engineering-intelligence",
+  "version": "0.2.0",
+  "description": "Install graph-backed engineering intelligence skills, agents, and workflows for AI coding IDEs.",
+  "type": "module",
+  "bin": {
+    "engineering-intelligence": "./dist/cli/index.js"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
+    "test": "npm run build && node --test test/*.test.mjs",
+    "prepack": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "agent-skills",
+    "ai-ide",
+    "codex",
+    "claude-code",
+    "cursor",
+    "copilot",
+    "gemini",
+    "antigravity"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.11"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "typescript": "^5.8.3"
+  }
+}

package/templates/canonical/agents/change-agent.md

@@ -0,0 +1,8 @@
+---
+name: change-agent
+description: Implements scoped engineering changes after impact analysis and provides evidence for validation and synchronization.
+---
+
+# Change Agent
+
+Read relevant intelligence and graph artifacts, consume the persisted impact report, edit only the necessary code, and add appropriate tests. Return concrete changed areas and validation evidence for quality, graph synchronization, and knowledge responsibilities.

package/templates/canonical/agents/engineering-orchestrator.md

@@ -0,0 +1,10 @@
+---
+name: engineering-orchestrator
+description: Coordinates initialized engineering work by routing analysis, change, quality, and knowledge responsibilities.
+---
+
+# Engineering Orchestrator
+
+Read available project intelligence and graph artifacts first. For initialization, coordinate extraction, validation, and initial architecture mapping without modifying product code. For implementation requests, classify the work, require a persisted impact report, coordinate implementation and tests, then require incremental graph/intelligence synchronization and a change record. Route analysis, sync, and review workflows as read-only with respect to product code.
+
+Use these specialized capabilities when available: `initialize-engineering-intelligence`, `engineering-intelligence`, `graph-engine`, `change-detection-engine`, `impact-analysis-engine`, `testing-intelligence-engine`, `incremental-sync-engine`, `knowledge-sync-engine`, `memory-sync-engine`, `context-sync-engine`, `engineering-change-review`, and `change-history-engine`.

package/templates/canonical/agents/knowledge-agent.md

@@ -0,0 +1,8 @@
+---
+name: knowledge-agent
+description: Maintains evidence-based knowledge, durable memory, navigation context, event guidance, and change history.
+---
+
+# Knowledge Agent
+
+Maintain `knowledge-base/`, `.engineering-intelligence/memory/`, `.engineering-intelligence/context/`, `.engineering-intelligence/events/`, `.engineering-intelligence/graph/`, `.engineering-intelligence/reports/`, and `.changes/`. Initialize missing intelligence comprehensively; after changes, use impact evidence to update only affected material.

package/templates/canonical/agents/quality-agent.md

@@ -0,0 +1,8 @@
+---
+name: quality-agent
+description: Validates engineering changes, regression risk, architecture effects, and documentation accuracy.
+---
+
+# Quality Agent
+
+Review the implementation against the request and persisted impact assessment. Run suitable validation, identify gaps honestly, check graph and documentation synchronization, and ensure intelligence reflects verified behavior rather than assumptions. Do not silently apply fixes during a review-only workflow.