engineering-loop 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Engineering Loop Standard Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,45 @@
+# engineering-loop
+
+CLI for the [Engineering Loop Standard](../../README.md): scaffolds
+`engineering-loop.json`, persistent `docs/memory/`, and generated adapters
+for Claude Code, Cursor, Aider, and Codex/Gemini.
+
+## Usage
+
+```bash
+npx engineering-loop init
+npx engineering-loop init --adapters claude,cursor --name my-app
+npx engineering-loop doctor
+```
+
+## Commands
+
+### `init`
+
+| Flag | Description | Default |
+|---|---|---|
+| `-d, --dir <path>` | Target directory | current directory |
+| `-n, --name <name>` | Project name written into `engineering-loop.json` | directory name |
+| `-a, --adapters <list>` | Comma-separated adapter ids (`claude,cursor,aider,codex,gemini`) | `claude,cursor,aider,codex` |
+| `-f, --force` | Overwrite existing files | `false` |
+
+### `doctor`
+
+| Flag | Description | Default |
+|---|---|---|
+| `-d, --dir <path>` | Project directory to validate | current directory |
+
+Exits non-zero if `engineering-loop.json` is missing, invalid against
+[the schema](../../engineering-loop.schema.json), or a required memory file
+is missing.
+
+## Development
+
+```bash
+npm install
+npm run build   # compiles src/ -> dist/, syncs the schema first
+npm test         # vitest
+npm run lint     # tsc --noEmit
+```
+
+See [../../docs/ADAPTERS.md](../../docs/ADAPTERS.md) to add a new adapter.

package/dist/adapters/aider.d.ts

@@ -0,0 +1,2 @@
+import type { Adapter } from "./types.js";
+export declare const aiderAdapter: Adapter;

package/dist/adapters/aider.js

@@ -0,0 +1,36 @@
+import { LOOP_PHASES, MANIFESTO_PRINCIPLES, renderCommandsBlock, renderLanguagePolicyLine, renderMemorySection, } from "./shared.js";
+function render(config) {
+    const name = config.project.name;
+    const manifesto = MANIFESTO_PRINCIPLES.map((p) => `* ${p}`).join("\n");
+    const phases = LOOP_PHASES.map((p, i) => `${i + 1}. ${p}`).join("\n");
+    const commands = renderCommandsBlock(config);
+    return `# Conventions — ${name}
+
+Pass this file to Aider with \`--read CONVENTIONS.md\` (or add it to
+\`.aider.conf.yml\`). Generated by the ELS Aider adapter from
+\`engineering-loop.json\`.
+
+## Engineering principles
+
+${manifesto}
+
+## Language policy
+
+${renderLanguagePolicyLine(config)}
+
+## Loop to follow for non-trivial changes
+
+${phases}
+
+## Project memory
+
+${renderMemorySection(config)}
+${commands.length > 0 ? `\n## Verification commands\n\n${commands.join("\n")}\n` : ""}`;
+}
+export const aiderAdapter = {
+    id: "aider",
+    label: "Aider",
+    outputPath: "CONVENTIONS.md",
+    render,
+};
+//# sourceMappingURL=aider.js.map

package/dist/adapters/aider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aider.js","sourceRoot":"","sources":["../../src/adapters/aider.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAErB,SAAS,MAAM,CAAC,MAA6B;IAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;IACjC,MAAM,SAAS,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAE7C,OAAO,mBAAmB,IAAI;;;;;;;;EAQ9B,SAAS;;;;EAIT,wBAAwB,CAAC,MAAM,CAAC;;;;EAIhC,MAAM;;;;EAIN,mBAAmB,CAAC,MAAM,CAAC;EAC3B,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,iCAAiC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACxF,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAY;IACnC,EAAE,EAAE,OAAO;IACX,KAAK,EAAE,OAAO;IACd,UAAU,EAAE,gBAAgB;IAC5B,MAAM;CACP,CAAC"}

package/dist/adapters/claude.d.ts

@@ -0,0 +1,2 @@
+import type { Adapter } from "./types.js";
+export declare const claudeAdapter: Adapter;

package/dist/adapters/claude.js

@@ -0,0 +1,42 @@
+import { LOOP_PHASES, MANIFESTO_PRINCIPLES, renderCommandsBlock, renderLanguagePolicyLine, renderMemorySection, } from "./shared.js";
+function render(config) {
+    const name = config.project.name;
+    const manifesto = MANIFESTO_PRINCIPLES.map((p, i) => `${i + 1}. **${p}**`).join("\n");
+    const phases = LOOP_PHASES.map((p, i) => `${i + 1}. ${p}`).join("\n");
+    const commands = renderCommandsBlock(config);
+    return `# CLAUDE.md - ${name}
+
+Generated by the Engineering Loop Standard (ELS) Claude Code adapter. This
+file is the binding contract for Claude Code working in this repository. See
+\`engineering-loop.json\` for the machine-readable source of truth this file
+is generated from.
+
+## Agentic Engineering Manifesto
+
+${manifesto}
+
+## Language policy
+
+${renderLanguagePolicyLine(config)} This applies even when the human author
+writes to Claude in a different language.
+
+## The 10-phase engineering loop
+
+For any non-trivial change (feature, bugfix, refactor, infra), work through:
+
+${phases}
+
+## Persistent memory
+
+${renderMemorySection(config)}
+
+${commands.length > 0 ? `## Commands\n\n${commands.join("\n")}\n` : ""}
+`;
+}
+export const claudeAdapter = {
+    id: "claude",
+    label: "Claude Code",
+    outputPath: "CLAUDE.md",
+    render,
+};
+//# sourceMappingURL=claude.js.map

package/dist/adapters/claude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../src/adapters/claude.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAErB,SAAS,MAAM,CAAC,MAA6B;IAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;IACjC,MAAM,SAAS,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtF,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAE7C,OAAO,iBAAiB,IAAI;;;;;;;;;EAS5B,SAAS;;;;EAIT,wBAAwB,CAAC,MAAM,CAAC;;;;;;;EAOhC,MAAM;;;;EAIN,mBAAmB,CAAC,MAAM,CAAC;;EAE3B,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,kBAAkB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;CACrE,CAAC;AACF,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAY;IACpC,EAAE,EAAE,QAAQ;IACZ,KAAK,EAAE,aAAa;IACpB,UAAU,EAAE,WAAW;IACvB,MAAM;CACP,CAAC"}

package/dist/adapters/codex.d.ts

@@ -0,0 +1,2 @@
+import type { Adapter } from "./types.js";
+export declare const codexAdapter: Adapter;

package/dist/adapters/codex.js

@@ -0,0 +1,37 @@
+import { LOOP_PHASES, MANIFESTO_PRINCIPLES, renderCommandsBlock, renderLanguagePolicyLine, renderMemorySection, } from "./shared.js";
+function render(config) {
+    const name = config.project.name;
+    const manifesto = MANIFESTO_PRINCIPLES.map((p, i) => `${i + 1}. ${p}`).join("\n");
+    const phases = LOOP_PHASES.map((p, i) => `${i + 1}. ${p}`).join("\n");
+    const commands = renderCommandsBlock(config);
+    return `# AGENTS.md — ${name}
+
+Read by Codex, Gemini, and any other agent that honors the AGENTS.md
+convention. Generated by the ELS adapter from \`engineering-loop.json\`.
+
+## Manifesto
+
+${manifesto}
+
+## Language policy
+
+${renderLanguagePolicyLine(config)}
+
+## Engineering loop
+
+For any non-trivial change, work through:
+
+${phases}
+
+## Memory
+
+${renderMemorySection(config)}
+${commands.length > 0 ? `\n## Commands\n\n${commands.join("\n")}\n` : ""}`;
+}
+export const codexAdapter = {
+    id: "codex",
+    label: "Codex / Gemini",
+    outputPath: "AGENTS.md",
+    render,
+};
+//# sourceMappingURL=codex.js.map

package/dist/adapters/codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../src/adapters/codex.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAErB,SAAS,MAAM,CAAC,MAA6B;IAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;IACjC,MAAM,SAAS,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClF,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAE7C,OAAO,iBAAiB,IAAI;;;;;;;EAO5B,SAAS;;;;EAIT,wBAAwB,CAAC,MAAM,CAAC;;;;;;EAMhC,MAAM;;;;EAIN,mBAAmB,CAAC,MAAM,CAAC;EAC3B,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,oBAAoB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAC3E,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAY;IACnC,EAAE,EAAE,OAAO;IACX,KAAK,EAAE,gBAAgB;IACvB,UAAU,EAAE,WAAW;IACvB,MAAM;CACP,CAAC"}

package/dist/adapters/cursor.d.ts

@@ -0,0 +1,2 @@
+import type { Adapter } from "./types.js";
+export declare const cursorAdapter: Adapter;

package/dist/adapters/cursor.js

@@ -0,0 +1,36 @@
+import { LOOP_PHASES, MANIFESTO_PRINCIPLES, renderCommandsBlock, renderLanguagePolicyLine, renderMemorySection, } from "./shared.js";
+function render(config) {
+    const name = config.project.name;
+    const manifesto = MANIFESTO_PRINCIPLES.map((p) => `- ${p}`).join("\n");
+    const phases = LOOP_PHASES.map((p, i) => `${i + 1}. ${p}`).join("\n");
+    const commands = renderCommandsBlock(config);
+    return `# ${name} — Engineering Loop Standard rules
+
+Generated by the ELS Cursor adapter from \`engineering-loop.json\`.
+
+## Principles
+
+${manifesto}
+
+## Language policy
+
+${renderLanguagePolicyLine(config)}
+
+## Loop
+
+Work through this sequence for any non-trivial change:
+
+${phases}
+
+## Memory
+
+${renderMemorySection(config)}
+${commands.length > 0 ? `\n## Commands\n\n${commands.join("\n")}\n` : ""}`;
+}
+export const cursorAdapter = {
+    id: "cursor",
+    label: "Cursor",
+    outputPath: ".cursorrules",
+    render,
+};
+//# sourceMappingURL=cursor.js.map

package/dist/adapters/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/adapters/cursor.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAErB,SAAS,MAAM,CAAC,MAA6B;IAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;IACjC,MAAM,SAAS,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAE7C,OAAO,KAAK,IAAI;;;;;;EAMhB,SAAS;;;;EAIT,wBAAwB,CAAC,MAAM,CAAC;;;;;;EAMhC,MAAM;;;;EAIN,mBAAmB,CAAC,MAAM,CAAC;EAC3B,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,oBAAoB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAC3E,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAY;IACpC,EAAE,EAAE,QAAQ;IACZ,KAAK,EAAE,QAAQ;IACf,UAAU,EAAE,cAAc;IAC1B,MAAM;CACP,CAAC"}

package/dist/adapters/index.d.ts

@@ -0,0 +1,5 @@
+import type { AdapterId } from "../types.js";
+import type { Adapter } from "./types.js";
+export declare const ADAPTERS: Record<AdapterId, Adapter>;
+export declare function resolveAdapters(ids: AdapterId[]): Adapter[];
+export type { Adapter } from "./types.js";

package/dist/adapters/index.js

@@ -0,0 +1,28 @@
+import { aiderAdapter } from "./aider.js";
+import { claudeAdapter } from "./claude.js";
+import { codexAdapter } from "./codex.js";
+import { cursorAdapter } from "./cursor.js";
+export const ADAPTERS = {
+    claude: claudeAdapter,
+    cursor: cursorAdapter,
+    aider: aiderAdapter,
+    codex: codexAdapter,
+    // Gemini currently shares the AGENTS.md convention with Codex.
+    gemini: codexAdapter,
+};
+export function resolveAdapters(ids) {
+    const seen = new Set();
+    const adapters = [];
+    for (const id of ids) {
+        const adapter = ADAPTERS[id];
+        if (!adapter) {
+            throw new Error(`Unknown adapter id: ${id}`);
+        }
+        if (seen.has(adapter.outputPath))
+            continue;
+        seen.add(adapter.outputPath);
+        adapters.push(adapter);
+    }
+    return adapters;
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,CAAC,MAAM,QAAQ,GAA+B;IAClD,MAAM,EAAE,aAAa;IACrB,MAAM,EAAE,aAAa;IACrB,KAAK,EAAE,YAAY;IACnB,KAAK,EAAE,YAAY;IACnB,+DAA+D;IAC/D,MAAM,EAAE,YAAY;CACrB,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,GAAgB;IAC9C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,MAAM,OAAO,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC;YAAE,SAAS;QAC3C,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC7B,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/adapters/shared.d.ts

@@ -0,0 +1,6 @@
+import type { EngineeringLoopConfig } from "../types.js";
+export declare const MANIFESTO_PRINCIPLES: string[];
+export declare const LOOP_PHASES: string[];
+export declare function renderLanguagePolicyLine(config: EngineeringLoopConfig): string;
+export declare function renderCommandsBlock(config: EngineeringLoopConfig): string[];
+export declare function renderMemorySection(config: EngineeringLoopConfig): string;

package/dist/adapters/shared.js

@@ -0,0 +1,44 @@
+export const MANIFESTO_PRINCIPLES = [
+    "Understand before acting. Never write code without full contextual knowledge.",
+    "Research before building. Search the repository for existing patterns before creating new ones.",
+    "Plan before execution. Draft a clear, step-by-step plan and assess risks before changing files.",
+    "Verify before completing. Run tests, linters, and type checks. An unverified change is an incomplete change.",
+    "Document as you go. Project memory must always reflect current reality.",
+    "Leave the codebase better than you found it. Maintain continuous refactoring and clean code principles.",
+];
+export const LOOP_PHASES = [
+    "Context Retrieval",
+    "Repository Research",
+    "Implementation Plan",
+    "Risk & Impact Assessment",
+    "Implementation",
+    "Automated Testing & Verification",
+    "Self-Healing & Bug Fixing",
+    "Refactoring",
+    "Memory & Documentation Update",
+    "Task Summary",
+];
+export function renderLanguagePolicyLine(config) {
+    const policy = config.language_policy;
+    if (!policy)
+        return "All code, comments, and documentation must be written in English.";
+    const parts = Object.entries(policy)
+        .filter((entry) => typeof entry[1] === "string")
+        .map(([key, value]) => `${key}=${value}`);
+    return `Required languages by artifact: ${parts.join(", ")}.`;
+}
+export function renderCommandsBlock(config) {
+    const commands = config.commands ?? {};
+    const lines = [];
+    for (const [key, value] of Object.entries(commands)) {
+        if (value)
+            lines.push(`- ${key}: \`${value}\``);
+    }
+    return lines;
+}
+export function renderMemorySection(config) {
+    const dir = config.memory.directory;
+    const files = config.memory.required_files.join(", ");
+    return `Persistent project memory lives in \`${dir}/\` (${files}). Read it during Phase 1 (Context Retrieval) and update whatever it makes stale during Phase 9 (Memory & Documentation Update).`;
+}
+//# sourceMappingURL=shared.js.map

package/dist/adapters/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/adapters/shared.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,+EAA+E;IAC/E,iGAAiG;IACjG,iGAAiG;IACjG,8GAA8G;IAC9G,yEAAyE;IACzE,yGAAyG;CAC1G,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,mBAAmB;IACnB,qBAAqB;IACrB,qBAAqB;IACrB,0BAA0B;IAC1B,gBAAgB;IAChB,kCAAkC;IAClC,2BAA2B;IAC3B,aAAa;IACb,+BAA+B;IAC/B,cAAc;CACf,CAAC;AAEF,MAAM,UAAU,wBAAwB,CAAC,MAA6B;IACpE,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC;IACtC,IAAI,CAAC,MAAM;QAAE,OAAO,mEAAmE,CAAC;IACxF,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;SACjC,MAAM,CAAC,CAAC,KAAK,EAA6B,EAAE,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC;SAC1E,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC;IAC5C,OAAO,mCAAmC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAA6B;IAC/D,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;IACvC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,IAAI,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,OAAO,KAAK,IAAI,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAA6B;IAC/D,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;IACpC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtD,OAAO,wCAAwC,GAAG,QAAQ,KAAK,kIAAkI,CAAC;AACpM,CAAC"}

package/dist/adapters/types.d.ts

@@ -0,0 +1,7 @@
+import type { AdapterId, EngineeringLoopConfig } from "../types.js";
+export interface Adapter {
+    id: AdapterId;
+    label: string;
+    outputPath: string;
+    render(config: EngineeringLoopConfig): string;
+}

package/dist/adapters/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/adapters/types.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,10 @@
+export interface DoctorCheck {
+    name: string;
+    passed: boolean;
+    detail?: string;
+}
+export interface DoctorReport {
+    ok: boolean;
+    checks: DoctorCheck[];
+}
+export declare function runDoctor(dir: string): Promise<DoctorReport>;

package/dist/commands/doctor.js

@@ -0,0 +1,53 @@
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { validateConfig } from "../schema.js";
+export async function runDoctor(dir) {
+    const checks = [];
+    const configPath = join(dir, "engineering-loop.json");
+    if (!existsSync(configPath)) {
+        checks.push({
+            name: "engineering-loop.json exists",
+            passed: false,
+            detail: `not found at ${configPath}`,
+        });
+        return { ok: false, checks };
+    }
+    checks.push({ name: "engineering-loop.json exists", passed: true });
+    let raw;
+    let parsed;
+    try {
+        raw = await readFile(configPath, "utf-8");
+        parsed = JSON.parse(raw);
+        checks.push({ name: "engineering-loop.json is valid JSON", passed: true });
+    }
+    catch (error) {
+        checks.push({
+            name: "engineering-loop.json is valid JSON",
+            passed: false,
+            detail: error instanceof Error ? error.message : String(error),
+        });
+        return { ok: false, checks };
+    }
+    const { valid, errors } = validateConfig(parsed);
+    checks.push({
+        name: "engineering-loop.json conforms to schema",
+        passed: valid,
+        detail: valid ? undefined : errors.join("; "),
+    });
+    if (valid) {
+        const config = parsed;
+        const memoryDir = join(dir, config.memory.directory);
+        for (const file of config.memory.required_files) {
+            const filePath = join(memoryDir, file);
+            const exists = existsSync(filePath);
+            checks.push({
+                name: `memory file present: ${config.memory.directory}/${file}`,
+                passed: exists,
+                detail: exists ? undefined : `missing at ${filePath}`,
+            });
+        }
+    }
+    return { ok: checks.every((c) => c.passed), checks };
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAc9C,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW;IACzC,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,uBAAuB,CAAC,CAAC;IAEtD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,8BAA8B;YACpC,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,gBAAgB,UAAU,EAAE;SACrC,CAAC,CAAC;QACH,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC/B,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,8BAA8B,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpE,IAAI,GAAW,CAAC;IAChB,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC1C,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,qCAAqC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,qCAAqC;YAC3C,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC/D,CAAC,CAAC;QACH,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC/B,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,CAAC,IAAI,CAAC;QACV,IAAI,EAAE,0CAA0C;QAChD,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;KAC9C,CAAC,CAAC;IAEH,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,MAAM,GAAG,MAA+B,CAAC;QAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACrD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YACvC,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;YACpC,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,wBAAwB,MAAM,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI,EAAE;gBAC/D,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,QAAQ,EAAE;aACtD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;AACvD,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,12 @@
+import type { AdapterId } from "../types.js";
+export interface InitOptions {
+    dir: string;
+    name?: string;
+    adapters?: AdapterId[];
+    force?: boolean;
+}
+export interface InitResult {
+    created: string[];
+    skipped: string[];
+}
+export declare function runInit(options: InitOptions): Promise<InitResult>;

package/dist/commands/init.js

@@ -0,0 +1,46 @@
+import { existsSync } from "node:fs";
+import { copyFile, mkdir, readdir, writeFile } from "node:fs/promises";
+import { basename, join } from "node:path";
+import { resolveAdapters } from "../adapters/index.js";
+import { buildDefaultConfig } from "../defaultConfig.js";
+import { TEMPLATES_DIR } from "../paths.js";
+async function writeIfAllowed(path, contents, force, result) {
+    if (!force && existsSync(path)) {
+        result.skipped.push(path);
+        return;
+    }
+    await writeFile(path, contents, "utf-8");
+    result.created.push(path);
+}
+export async function runInit(options) {
+    const targetDir = options.dir;
+    const projectName = options.name ?? basename(targetDir);
+    const result = { created: [], skipped: [] };
+    await mkdir(targetDir, { recursive: true });
+    const config = buildDefaultConfig(projectName);
+    if (options.adapters && options.adapters.length > 0) {
+        config.adapters = options.adapters;
+    }
+    const configPath = join(targetDir, "engineering-loop.json");
+    await writeIfAllowed(configPath, `${JSON.stringify(config, null, 2)}\n`, Boolean(options.force), result);
+    const memoryDir = join(targetDir, config.memory.directory);
+    await mkdir(memoryDir, { recursive: true });
+    const templateFiles = await readdir(TEMPLATES_DIR);
+    for (const file of templateFiles) {
+        const destination = join(memoryDir, file);
+        if (!options.force && existsSync(destination)) {
+            result.skipped.push(destination);
+            continue;
+        }
+        await copyFile(join(TEMPLATES_DIR, file), destination);
+        result.created.push(destination);
+    }
+    const adapterIds = config.adapters ?? [];
+    const adapters = resolveAdapters(adapterIds);
+    for (const adapter of adapters) {
+        const outputPath = join(targetDir, adapter.outputPath);
+        await writeIfAllowed(outputPath, adapter.render(config), Boolean(options.force), result);
+    }
+    return result;
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/defaultConfig.d.ts

@@ -0,0 +1,4 @@
+import type { AdapterId, EngineeringLoopConfig } from "./types.js";
+export declare const DEFAULT_MEMORY_FILES: string[];
+export declare const DEFAULT_ADAPTERS: AdapterId[];
+export declare function buildDefaultConfig(projectName: string): EngineeringLoopConfig;

package/dist/defaultConfig.js

@@ -0,0 +1,43 @@
+export const DEFAULT_MEMORY_FILES = [
+    "PROJECT.md",
+    "ARCHITECTURE.md",
+    "ROADMAP.md",
+    "TASKS.md",
+    "DECISIONS.md",
+    "KNOWLEDGE.md",
+];
+export const DEFAULT_ADAPTERS = ["claude", "cursor", "aider", "codex"];
+export function buildDefaultConfig(projectName) {
+    return {
+        $schema: "./engineering-loop.schema.json",
+        version: "1.0.0",
+        project: {
+            name: projectName,
+        },
+        memory: {
+            directory: "docs/memory",
+            required_files: [...DEFAULT_MEMORY_FILES],
+        },
+        pipeline: {
+            pre_code: ["research", "plan"],
+            post_code: ["lint", "test", "refactor", "update_docs"],
+        },
+        commands: {
+            test: "npm test",
+            lint: "npm run lint",
+            build: "npm run build",
+        },
+        language_policy: {
+            code: "en",
+            comments: "en",
+            docs: "en",
+            commits: "en",
+        },
+        agents: {
+            allow_auto_fix: true,
+            max_repair_iterations: 3,
+        },
+        adapters: [...DEFAULT_ADAPTERS],
+    };
+}
+//# sourceMappingURL=defaultConfig.js.map

package/dist/defaultConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultConfig.js","sourceRoot":"","sources":["../src/defaultConfig.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,YAAY;IACZ,iBAAiB;IACjB,YAAY;IACZ,UAAU;IACV,cAAc;IACd,cAAc;CACf,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAEpF,MAAM,UAAU,kBAAkB,CAAC,WAAmB;IACpD,OAAO;QACL,OAAO,EAAE,gCAAgC;QACzC,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE;YACP,IAAI,EAAE,WAAW;SAClB;QACD,MAAM,EAAE;YACN,SAAS,EAAE,aAAa;YACxB,cAAc,EAAE,CAAC,GAAG,oBAAoB,CAAC;SAC1C;QACD,QAAQ,EAAE;YACR,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC;YAC9B,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,CAAC;SACvD;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,cAAc;YACpB,KAAK,EAAE,eAAe;SACvB;QACD,eAAe,EAAE;YACf,IAAI,EAAE,IAAI;YACV,QAAQ,EAAE,IAAI;YACd,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,IAAI;SACd;QACD,MAAM,EAAE;YACN,cAAc,EAAE,IAAI;YACpB,qBAAqB,EAAE,CAAC;SACzB;QACD,QAAQ,EAAE,CAAC,GAAG,gBAAgB,CAAC;KAChC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { Command } from "commander";
+import { runDoctor } from "./commands/doctor.js";
+import { runInit } from "./commands/init.js";
+import { PACKAGE_ROOT } from "./paths.js";
+const pkg = JSON.parse(readFileSync(join(PACKAGE_ROOT, "package.json"), "utf-8"));
+const VALID_ADAPTER_IDS = ["claude", "cursor", "aider", "codex", "gemini"];
+function parseAdapters(value) {
+    const ids = value.split(",").map((s) => s.trim());
+    for (const id of ids) {
+        if (!VALID_ADAPTER_IDS.includes(id)) {
+            throw new Error(`Unknown adapter "${id}". Valid adapters: ${VALID_ADAPTER_IDS.join(", ")}`);
+        }
+    }
+    return ids;
+}
+const program = new Command();
+program
+    .name("engineering-loop")
+    .description("Scaffold and validate the Engineering Loop Standard in a project")
+    .version(pkg.version);
+program
+    .command("init")
+    .description("Create engineering-loop.json, docs/memory/, and generate agent adapters")
+    .option("-d, --dir <path>", "target directory", process.cwd())
+    .option("-n, --name <name>", "project name (defaults to the directory name)")
+    .option("-a, --adapters <list>", "comma-separated adapters to generate (claude,cursor,aider,codex,gemini)")
+    .option("-f, --force", "overwrite existing files", false)
+    .action(async (opts) => {
+    try {
+        const adapters = opts.adapters ? parseAdapters(opts.adapters) : undefined;
+        const result = await runInit({
+            dir: opts.dir,
+            name: opts.name,
+            adapters,
+            force: opts.force,
+        });
+        for (const file of result.created) {
+            console.log(`✔ Created ${file}`);
+        }
+        for (const file of result.skipped) {
+            console.log(`– Skipped ${file} (already exists, use --force to overwrite)`);
+        }
+        console.log("\nEngineering Loop ready.");
+    }
+    catch (error) {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exitCode = 1;
+    }
+});
+program
+    .command("doctor")
+    .description("Validate that a project conforms to the Engineering Loop Standard")
+    .option("-d, --dir <path>", "project directory", process.cwd())
+    .action(async (opts) => {
+    const report = await runDoctor(opts.dir);
+    for (const check of report.checks) {
+        const icon = check.passed ? "✔" : "✗";
+        const detail = check.detail ? ` (${check.detail})` : "";
+        console.log(`${icon} ${check.name}${detail}`);
+    }
+    if (!report.ok) {
+        process.exitCode = 1;
+    }
+});
+program.parseAsync(process.argv);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/paths.d.ts

@@ -0,0 +1,3 @@
+export declare const PACKAGE_ROOT: string;
+export declare const TEMPLATES_DIR: string;
+export declare const SCHEMA_PATH: string;

package/dist/paths.js

@@ -0,0 +1,11 @@
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+// This file must stay directly under src/ (compiling to dist/paths.js one
+// level below the package root) so PACKAGE_ROOT resolves correctly whether
+// running compiled (dist/paths.js) or via tsx in dev (src/paths.ts) — both
+// sit exactly one directory below the package root.
+const thisFileDir = dirname(fileURLToPath(import.meta.url));
+export const PACKAGE_ROOT = dirname(thisFileDir);
+export const TEMPLATES_DIR = join(PACKAGE_ROOT, "templates", "memory");
+export const SCHEMA_PATH = join(PACKAGE_ROOT, "schema", "engineering-loop.schema.json");
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,0EAA0E;AAC1E,2EAA2E;AAC3E,2EAA2E;AAC3E,oDAAoD;AACpD,MAAM,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC5D,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;AAEjD,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;AACvE,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,EAAE,QAAQ,EAAE,8BAA8B,CAAC,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,5 @@
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+export declare function validateConfig(data: unknown): ValidationResult;

package/dist/schema.js

@@ -0,0 +1,25 @@
+import { readFileSync } from "node:fs";
+import { Ajv2020 } from "ajv/dist/2020.js";
+import { SCHEMA_PATH } from "./paths.js";
+let compiledValidator;
+let lastErrors;
+function getValidator() {
+    if (!compiledValidator) {
+        const schema = JSON.parse(readFileSync(SCHEMA_PATH, "utf-8"));
+        const ajv = new Ajv2020({ allErrors: true, strict: false });
+        const validate = ajv.compile(schema);
+        compiledValidator = (data) => {
+            const ok = validate(data);
+            lastErrors = validate.errors;
+            return ok;
+        };
+    }
+    return compiledValidator;
+}
+export function validateConfig(data) {
+    const validate = getValidator();
+    const valid = validate(data);
+    const errors = (lastErrors ?? []).map((err) => `${err.instancePath || "/"} ${err.message ?? "is invalid"}`);
+    return { valid, errors };
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,IAAI,iBAA2D,CAAC;AAChE,IAAI,UAA4C,CAAC;AAEjD,SAAS,YAAY;IACnB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;QAC9D,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5D,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACrC,iBAAiB,GAAG,CAAC,IAAa,EAAE,EAAE;YACpC,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC1B,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC;YAC7B,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAOD,MAAM,UAAU,cAAc,CAAC,IAAa;IAC1C,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CACnC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,YAAY,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,IAAI,YAAY,EAAE,CACrE,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,37 @@
+export interface EngineeringLoopConfig {
+    $schema?: string;
+    version: string;
+    project: {
+        name: string;
+        description?: string;
+        architecture_style?: string;
+    };
+    memory: {
+        directory: string;
+        required_files: string[];
+    };
+    pipeline?: {
+        pre_code?: string[];
+        post_code?: string[];
+    };
+    commands?: {
+        test?: string;
+        lint?: string;
+        build?: string;
+        format?: string;
+        [key: string]: string | undefined;
+    };
+    language_policy?: {
+        code?: string;
+        comments?: string;
+        docs?: string;
+        commits?: string;
+        [key: string]: string | undefined;
+    };
+    agents?: {
+        allow_auto_fix?: boolean;
+        max_repair_iterations?: number;
+    };
+    adapters?: AdapterId[];
+}
+export type AdapterId = "claude" | "cursor" | "aider" | "codex" | "gemini";

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "engineering-loop",
+  "version": "1.0.0",
+  "description": "CLI for the Engineering Loop Standard: scaffold engineering-loop.json, persistent project memory, and multi-tool AI agent adapters.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "engineering-loop": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "templates",
+    "schema"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "prebuild": "node scripts/sync-schema.mjs",
+    "build": "tsc -p tsconfig.json",
+    "pretest": "node scripts/sync-schema.mjs",
+    "test": "vitest run",
+    "lint": "tsc -p tsconfig.json --noEmit",
+    "dev": "tsx src/index.ts"
+  },
+  "dependencies": {
+    "ajv": "^8.14.0",
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "tsx": "^4.16.0",
+    "typescript": "^5.5.0",
+    "vitest": "^1.6.0"
+  },
+  "keywords": [
+    "engineering-loop",
+    "ai-agents",
+    "claude-code",
+    "cursor",
+    "aider",
+    "codex",
+    "specification",
+    "cli"
+  ]
+}

package/schema/engineering-loop.schema.json

@@ -0,0 +1,130 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://engineering-loop.org/schema/v1.json",
+  "title": "Engineering Loop Standard Configuration",
+  "description": "Formal schema for engineering-loop.json, the single source of truth an Engineering Loop Standard adapter is generated from.",
+  "type": "object",
+  "required": ["version", "project", "memory"],
+  "additionalProperties": false,
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "Pointer back to this schema, for editor validation."
+    },
+    "version": {
+      "type": "string",
+      "description": "Version of the Engineering Loop Standard this config conforms to, in semver.",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "project": {
+      "type": "object",
+      "required": ["name"],
+      "additionalProperties": false,
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "description": {
+          "type": "string"
+        },
+        "architecture_style": {
+          "type": "string",
+          "description": "Free-text label, e.g. modular-monolith, microservices, monorepo, cli-tool."
+        }
+      }
+    },
+    "memory": {
+      "type": "object",
+      "required": ["directory", "required_files"],
+      "additionalProperties": false,
+      "properties": {
+        "directory": {
+          "type": "string",
+          "description": "Path, relative to the project root, holding persistent memory files.",
+          "default": "docs/memory"
+        },
+        "required_files": {
+          "type": "array",
+          "description": "Filenames that must exist inside the memory directory.",
+          "items": { "type": "string" },
+          "minItems": 1,
+          "default": [
+            "PROJECT.md",
+            "ARCHITECTURE.md",
+            "ROADMAP.md",
+            "TASKS.md",
+            "DECISIONS.md",
+            "KNOWLEDGE.md"
+          ]
+        }
+      }
+    },
+    "pipeline": {
+      "type": "object",
+      "description": "Ordered phase names run before and after code changes. Phase names are free-text so tools can extend them.",
+      "additionalProperties": false,
+      "properties": {
+        "pre_code": {
+          "type": "array",
+          "items": { "type": "string" },
+          "default": ["research", "plan"]
+        },
+        "post_code": {
+          "type": "array",
+          "items": { "type": "string" },
+          "default": ["lint", "test", "refactor", "update_docs"]
+        }
+      }
+    },
+    "commands": {
+      "type": "object",
+      "description": "Shell commands an agent should run for each verification step.",
+      "additionalProperties": { "type": "string" },
+      "properties": {
+        "test": { "type": "string" },
+        "lint": { "type": "string" },
+        "build": { "type": "string" },
+        "format": { "type": "string" }
+      }
+    },
+    "language_policy": {
+      "type": "object",
+      "description": "ISO 639-1 language codes required for each artifact category.",
+      "additionalProperties": { "type": "string", "pattern": "^[a-z]{2}$" },
+      "properties": {
+        "code": { "type": "string", "pattern": "^[a-z]{2}$", "default": "en" },
+        "comments": { "type": "string", "pattern": "^[a-z]{2}$", "default": "en" },
+        "docs": { "type": "string", "pattern": "^[a-z]{2}$", "default": "en" },
+        "commits": { "type": "string", "pattern": "^[a-z]{2}$", "default": "en" }
+      }
+    },
+    "agents": {
+      "type": "object",
+      "description": "Behavioral limits applied to any agent following this config.",
+      "additionalProperties": false,
+      "properties": {
+        "allow_auto_fix": {
+          "type": "boolean",
+          "description": "Whether an agent may automatically repair failing tests/lint without asking first.",
+          "default": true
+        },
+        "max_repair_iterations": {
+          "type": "integer",
+          "description": "Upper bound on Phase 7 (Self-Healing) retry loops before an agent must stop and ask for help.",
+          "minimum": 1,
+          "default": 3
+        }
+      }
+    },
+    "adapters": {
+      "type": "array",
+      "description": "Adapters to generate when running `engineering-loop init` or `engineering-loop sync`.",
+      "items": {
+        "type": "string",
+        "enum": ["claude", "cursor", "aider", "codex", "gemini"]
+      },
+      "default": ["claude", "cursor", "aider", "codex"]
+    }
+  }
+}

package/templates/memory/ARCHITECTURE.md

@@ -0,0 +1,13 @@
+# Architecture
+
+## Overview
+
+<!-- High-level diagram or description of major components. -->
+
+## Data flow
+
+<!-- How a request/task moves through the system. -->
+
+## Design decisions
+
+<!-- Link to DECISIONS.md for the "why" behind non-obvious choices. -->

package/templates/memory/DECISIONS.md

@@ -0,0 +1,12 @@
+# Decisions
+
+Architecture Decision Records. Newest first.
+
+---
+
+## ADR-001: <title>
+
+**Date:** <YYYY-MM-DD>
+**Status:** Proposed | Accepted | Superseded
+
+<!-- What was decided, what alternatives were considered, and why this one won. -->

package/templates/memory/KNOWLEDGE.md

@@ -0,0 +1,8 @@
+# Knowledge
+
+Domain insights and lessons that aren't obvious from reading the code.
+
+<!--
+- One bullet per insight.
+- Prefer "why" over "what" — the code already shows what.
+-->

package/templates/memory/PROJECT.md

@@ -0,0 +1,17 @@
+# Project
+
+## What this is
+
+<!-- One or two sentences: what does this project do, and for whom? -->
+
+## Tech stack
+
+<!-- Languages, frameworks, datastores, notable infrastructure. -->
+
+## Language policy
+
+<!-- Should generally match the `language_policy` block in engineering-loop.json. -->
+
+## Current status
+
+<!-- One line pointing to ROADMAP.md / TASKS.md for detail. -->

package/templates/memory/ROADMAP.md

@@ -0,0 +1,13 @@
+# Roadmap
+
+## Now
+
+<!-- What's actively planned for the current milestone. -->
+
+## Next
+
+<!-- What's planned after that. -->
+
+## Later / unscheduled
+
+<!-- Ideas not yet committed to a milestone. -->

package/templates/memory/TASKS.md

@@ -0,0 +1,13 @@
+# Tasks
+
+## Active
+
+<!-- What's being worked on right now, by whom. -->
+
+## Backlog
+
+<!-- See ROADMAP.md for direction; this is day-to-day state. -->
+
+## Done (recent)
+
+<!-- Short log of recently completed tasks, newest first. -->