@rsaglobaltech/specgate 0.8.1

package/dist/scripts/harness/init.js

@@ -0,0 +1,358 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * `harness init` — scaffold `harness.config.yaml` and `.harness/prompt-prefix.md`.
+ *
+ * The config was documented in the tutorial and named in `harness run`'s own
+ * error message ("set `agent:` in harness.config.yaml") long before anything
+ * created it, so every project had to hand-copy it out of a guide. A tool that
+ * documents a config file and never writes one is asking its users to do the
+ * scaffolder's job.
+ *
+ * Usage:
+ *   specgate harness init [--project-dir <dir>] [--test-cmd <cmd>]
+ *                                       [--force] [--stdout] [--json]
+ */
+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.GITATTRIBUTES_LINE = exports.MERGE_DRIVER_NAME = exports.InitCommand = void 0;
+exports.detectTestCommand = detectTestCommand;
+exports.projectName = projectName;
+exports.installMergeDriver = installMergeDriver;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const PackSpec_1 = require("../../packages/core/src/domain/PackSpec");
+const project_root_1 = require("../lib/project-root");
+const agent_1 = require("../lib/agent");
+const diagnostics_1 = require("../lib/diagnostics");
+const command_1 = require("../lib/command");
+const ROOT_DIR = path.resolve(__dirname, "..", "..", "..");
+const TEMPLATES = path.join(ROOT_DIR, "templates", "harness");
+const CONFIG_FILE = "harness.config.yaml";
+const PREFIX_FILE = path.join(".harness", "prompt-prefix.md");
+const NULL_SHAPE = { projectDir: null, files: [] };
+/**
+ * Guess the project's extra gate from the build file that is actually present,
+ * or `null` when nothing gives it away.
+ *
+ * `null` matters more than the guesses. `test_cmd` is an *additional* gate —
+ * `harness run` always runs `validate --strict-tdd` first — so leaving it
+ * unset is safe, while filling it with a placeholder is not. A placeholder
+ * like `echo "set this"` exits 0, which is a gate that passes unconditionally:
+ * the harness would mark requirements done without ever running a test. A
+ * freshly scaffolded project has no build file yet precisely because no code
+ * exists, so this is the common case, not the edge one.
+ */
+function detectTestCommand(projectDir) {
+    const has = (file) => fs.existsSync(path.join(projectDir, file));
+    if (has("package.json")) {
+        try {
+            const pkg = JSON.parse(fs.readFileSync(path.join(projectDir, "package.json"), "utf8"));
+            const scripts = pkg.scripts || {};
+            // `verify` is this project's own convention for "the fast gate";
+            // prefer it, because `test` in a spec-driven repo often includes the
+            // end-to-end suite that stays red until the last requirement lands.
+            if (scripts.verify)
+                return "npm run verify";
+            if (scripts.test)
+                return "npm test";
+        }
+        catch {
+            // A malformed package.json is the user's problem, not a reason to fail
+            // scaffolding. Fall through to the generic guess.
+        }
+        return "npm test";
+    }
+    if (has("pom.xml"))
+        return "mvn -B test";
+    if (has("build.gradle") || has("build.gradle.kts"))
+        return "./gradlew test";
+    if (has("Cargo.toml"))
+        return "cargo test";
+    if (has("go.mod"))
+        return "go test ./...";
+    if (has("pyproject.toml") || has("setup.py"))
+        return "pytest";
+    return null;
+}
+function projectName(projectDir) {
+    const specPath = path.join(projectDir, "spec.md");
+    if (fs.existsSync(specPath)) {
+        const heading = /^#\s+(.+)$/m.exec(fs.readFileSync(specPath, "utf8"));
+        if (heading)
+            return heading[1].trim();
+    }
+    return path.basename(projectDir);
+}
+function usage() {
+    process.stdout.write("\n  🤖 harness init — scaffold the harness configuration\n\n" +
+        "  USAGE\n" +
+        "    specgate harness init [options]\n\n" +
+        "  WRITES\n" +
+        `    ${CONFIG_FILE}        agent, gate, retries, CI mode\n` +
+        `    ${PREFIX_FILE}   Role / Active Project Boundary / Execution Policy\n\n` +
+        "  OPTIONS\n" +
+        "    --project-dir <dir>  Project root (auto-detected from cwd if omitted).\n" +
+        "    --test-cmd <cmd>     The gate. Detected from the build files if omitted.\n" +
+        "    --force              Overwrite files that already exist.\n" +
+        "    --stdout             Print both files instead of writing them.\n" +
+        "    --json               Machine-readable output.\n" +
+        "    -h, --help           Show this help.\n\n");
+}
+function parseArgs(argv) {
+    const opts = {
+        projectDir: ".",
+        testCmd: null,
+        force: false,
+        stdout: false,
+        json: (0, agent_1.wantsJson)(argv),
+    };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === "--project-dir" && argv[i + 1])
+            opts.projectDir = argv[++i];
+        else if (a === "--test-cmd" && argv[i + 1])
+            opts.testCmd = argv[++i];
+        else if (a === "--force")
+            opts.force = true;
+        else if (a === "--stdout")
+            opts.stdout = true;
+        else if (a === "--json")
+            continue;
+        else if (a === "--format" && argv[i + 1] === "json")
+            i++;
+        else if (a === "--help" || a === "-h") {
+            usage();
+            process.exit(0);
+        }
+        else {
+            process.stderr.write(`Unknown argument: ${a}\n`);
+            usage();
+            process.exit(2);
+        }
+    }
+    return opts;
+}
+class InitCommand extends command_1.BaseCommand {
+    execute() {
+        let argv = this.args;
+        // Reachable as `harness init …` through the dispatcher, or directly.
+        if (argv[0] === "harness")
+            argv = argv.slice(1);
+        if (argv[0] === "init")
+            argv = argv.slice(1);
+        const opts = parseArgs(argv);
+        const io = (0, agent_1.agentIo)(opts.json);
+        let projectDir;
+        try {
+            projectDir = (0, project_root_1.resolveProjectDir)(opts.projectDir);
+        }
+        catch (err) {
+            io.usage(NULL_SHAPE, [
+                (0, diagnostics_1.error)("no_project", (0, diagnostics_1.errorMessage)(err), {
+                    fix: "Run from inside a spec-driven project, or pass --project-dir <path>.",
+                }),
+            ]);
+            return;
+        }
+        const testCmd = opts.testCmd || detectTestCommand(projectDir);
+        // Rendered into the config as a live key when known, and as a commented-out
+        // one when not — see detectTestCommand for why a placeholder would be worse
+        // than an absent key.
+        const vars = {
+            PROJECT_NAME: projectName(projectDir),
+            TEST_CMD_LINE: testCmd
+                ? `test_cmd: "${testCmd}"`
+                : '# test_cmd: "npm test"   # ← set this once the project has a test command',
+            GATE_COMMAND: testCmd
+                ? `${testCmd}\nspecgate validate . --strict-tdd`
+                : "specgate validate . --strict-tdd",
+        };
+        const outputs = [
+            {
+                dest: CONFIG_FILE,
+                body: (0, PackSpec_1.renderTemplate)(fs.readFileSync(path.join(TEMPLATES, "harness.config.yaml.tpl"), "utf8"), vars),
+            },
+            {
+                dest: PREFIX_FILE,
+                body: (0, PackSpec_1.renderTemplate)(fs.readFileSync(path.join(TEMPLATES, "prompt-prefix.md.tpl"), "utf8"), vars),
+            },
+        ];
+        if (opts.stdout) {
+            io.emit({ projectDir, testCmd, files: outputs.map((o) => o.dest) }, () => {
+                for (const out of outputs) {
+                    process.stdout.write(`# ── ${out.dest} ${"─".repeat(Math.max(0, 60 - out.dest.length))}\n`);
+                    process.stdout.write(out.body);
+                    process.stdout.write("\n");
+                }
+            });
+            return;
+        }
+        const existing = outputs
+            .map((o) => o.dest)
+            .filter((dest) => fs.existsSync(path.join(projectDir, dest)));
+        if (existing.length > 0 && !opts.force) {
+            io.fail({ ...NULL_SHAPE, projectDir }, [
+                (0, diagnostics_1.error)("harness_config_exists", `Already present: ${existing.join(", ")}`, {
+                    target: existing[0],
+                    fix: "Re-run with --force to overwrite, or --stdout to print and merge by hand.",
+                }),
+            ]);
+            return;
+        }
+        const written = [];
+        for (const out of outputs) {
+            const abs = path.join(projectDir, out.dest);
+            fs.mkdirSync(path.dirname(abs), { recursive: true });
+            fs.writeFileSync(abs, out.body, "utf8");
+            written.push(out.dest);
+        }
+        // Registered here because this is where a project is set up to run the
+        // harness, and the driver only matters once branches come back in parallel.
+        const driverProblem = installMergeDriver(projectDir);
+        const status = [
+            (0, diagnostics_1.info)("harness_agent_unset", "No agent is configured, deliberately.", {
+                fix: 'Pass it explicitly: specgate harness run --req REQ-001 --agent "<cmd> < {prompt_file}"',
+            }),
+        ];
+        if (driverProblem)
+            status.push(driverProblem);
+        else
+            status.push((0, diagnostics_1.info)("merge_driver_registered", "docs/specs/traceability.md now merges row by row, so parallel harness branches do not collide.", {
+                target: ".gitattributes",
+                fix: "Commit .gitattributes. Every other clone and CI runs `specgate harness init` once to register the driver in its own git config.",
+            }));
+        if (!testCmd) {
+            status.push((0, diagnostics_1.warning)("harness_test_cmd_unset", "No test command detected, so `test_cmd` is commented out.", {
+                target: CONFIG_FILE,
+                fix: "Set it once the project has one. Until then the gate is `validate --strict-tdd` alone, which is a real gate — a placeholder that exits 0 would not be.",
+            }));
+        }
+        io.emit({
+            projectDir,
+            testCmd,
+            files: written,
+            status,
+        }, () => {
+            for (const file of written)
+                process.stdout.write(`ℹ️ [INFO] write ${file}\n`);
+            process.stdout.write("ℹ️ [INFO] ✅ Harness configured.\n" +
+                `ℹ️ [INFO]   gate: validate --strict-tdd${testCmd ? ` + ${testCmd}` : " (no test command detected)"}\n` +
+                "ℹ️ [INFO]   agent: not set — that is your choice and your credentials.\n" +
+                "ℹ️ [INFO] Next:\n" +
+                "ℹ️ [INFO]   1. Read .harness/prompt-prefix.md and make it sound like your team.\n" +
+                "ℹ️ [INFO]   2. specgate harness prompt REQ-001        — see it before paying for it\n" +
+                'ℹ️ [INFO]   3. specgate harness run --req REQ-001 --agent "<cmd> < {prompt_file}"\n');
+        });
+    }
+}
+exports.InitCommand = InitCommand;
+// ── the traceability merge driver ────────────────────────────────────────────
+/** What `.gitattributes` must say for git to route the matrix to our driver. */
+exports.MERGE_DRIVER_NAME = "csda-matrix";
+exports.GITATTRIBUTES_LINE = `docs/specs/traceability.md merge=${exports.MERGE_DRIVER_NAME}`;
+/**
+ * Register the row-wise merge driver for `docs/specs/traceability.md`.
+ *
+ * Parallel harness runs produce one branch per requirement, each flipping its
+ * own row. Git merges by lines and needs an unchanged line between two changed
+ * regions, so two edits one row apart collide even though they are independent
+ * — measured: rows 1 and 2 conflict, rows 1 and 5 do not. The driver merges by
+ * row instead. See `packages/core/src/domain/TraceabilityMerge.ts`.
+ *
+ * This takes two halves, and only the first is committed:
+ *
+ *   - `.gitattributes` routes the file. It is part of the repository, so every
+ *     clone gets it.
+ *   - `merge.csda-matrix.driver` is **local git config**, which nothing can
+ *     commit. Each clone and each CI job registers it, and that is why
+ *     `specgate doctor` checks for the gap.
+ *
+ * Without the config git falls back to its built-in merge — the conflict a
+ * project has today. That fallback is deliberate: an unregistered checkout is
+ * never silently wrong, only unhelped, so this can be adopted one clone at a
+ * time.
+ *
+ * @returns a diagnostic when the driver could not be registered, else null
+ */
+function installMergeDriver(projectDir) {
+    const attributesPath = path.join(projectDir, ".gitattributes");
+    const existing = fs.existsSync(attributesPath) ? fs.readFileSync(attributesPath, "utf8") : "";
+    if (!existing.includes(exports.GITATTRIBUTES_LINE)) {
+        const separator = existing === "" || existing.endsWith("\n") ? "" : "\n";
+        fs.appendFileSync(attributesPath, `${separator}# Merge the traceability matrix row by row, so parallel harness\n` +
+            `# branches do not collide on adjacent rows. Needs the driver registered:\n` +
+            `#   specgate harness init --project-dir .\n` +
+            `${exports.GITATTRIBUTES_LINE}\n`, "utf8");
+    }
+    // The driver runs from the installed CLI, so the path is resolved here rather
+    // than assumed: a project does not have specgate in its own tree.
+    const driverScript = path.join(__dirname, "..", "merge-traceability.js");
+    const gitConfig = (key, value) => (0, node_child_process_1.spawnSync)("git", ["-C", projectDir, "config", key, value], { encoding: "utf8" });
+    // Order matters, and getting it wrong is worse than not doing it at all.
+    //
+    // Git has three states for a driver named in .gitattributes:
+    //
+    //   neither `name` nor `driver` set  → falls back to the built-in merge.
+    //                                      A fresh clone is here, and it is fine.
+    //   `name` set, `driver` missing     → `fatal: custom merge driver
+    //                                      csda-matrix lacks command line`. The
+    //                                      file cannot be merged AT ALL — worse
+    //                                      than the conflict this feature exists
+    //                                      to remove.
+    //   both set                         → the driver runs.
+    //
+    // So `driver` goes in first and `name` only follows if it landed; and if it
+    // did not, any stale `name` is removed rather than left pointing at nothing.
+    const configured = gitConfig(`merge.${exports.MERGE_DRIVER_NAME}.driver`, `node ${JSON.stringify(driverScript)} %O %A %B`);
+    if (configured.status !== 0) {
+        (0, node_child_process_1.spawnSync)("git", ["-C", projectDir, "config", "--unset", `merge.${exports.MERGE_DRIVER_NAME}.name`], {
+            encoding: "utf8",
+        });
+        return (0, diagnostics_1.warning)("merge_driver_not_registered", "Could not register the traceability merge driver in git config.", {
+            target: ".gitattributes",
+            fix: `Run it by hand inside the project:\n` +
+                `  git config merge.${exports.MERGE_DRIVER_NAME}.driver 'node ${driverScript} %O %A %B'\n` +
+                "Until then git uses its built-in merge, which conflicts when two " +
+                "harness branches touch adjacent rows.",
+        });
+    }
+    gitConfig(`merge.${exports.MERGE_DRIVER_NAME}.name`, "csda traceability matrix merge");
+    return null;
+}
+if (require.main === module)
+    new InitCommand(process.argv.slice(2)).execute();
+//# sourceMappingURL=init.js.map

package/dist/scripts/harness/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../scripts/harness/init.ts"],"names":[],"mappings":";;AACA;;;;;;;;;;;;GAYG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BH,8CAuBC;AAED,kCAOC;AAwOD,gDA8DC;AAnWD,4CAA8B;AAC9B,gDAAkC;AAClC,2DAA+C;AAC/C,sEAAyE;AACzE,sDAAwD;AACxD,wCAAkD;AAClD,oDAAwE;AACxE,4CAA6C;AAE7C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;AAE9D,MAAM,WAAW,GAAG,qBAAqB,CAAC;AAC1C,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;AAE9D,MAAM,UAAU,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAEnD;;;;;;;;;;;GAWG;AACH,SAAgB,iBAAiB,CAAC,UAAU;IAC1C,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;IACjE,IAAI,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;YACvF,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;YAClC,iEAAiE;YACjE,qEAAqE;YACrE,oEAAoE;YACpE,IAAI,OAAO,CAAC,MAAM;gBAAE,OAAO,gBAAgB,CAAC;YAC5C,IAAI,OAAO,CAAC,IAAI;gBAAE,OAAO,UAAU,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,uEAAuE;YACvE,kDAAkD;QACpD,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IAAI,GAAG,CAAC,SAAS,CAAC;QAAE,OAAO,aAAa,CAAC;IACzC,IAAI,GAAG,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC,kBAAkB,CAAC;QAAE,OAAO,gBAAgB,CAAC;IAC5E,IAAI,GAAG,CAAC,YAAY,CAAC;QAAE,OAAO,YAAY,CAAC;IAC3C,IAAI,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,eAAe,CAAC;IAC1C,IAAI,GAAG,CAAC,gBAAgB,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC9D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,WAAW,CAAC,UAAU;IACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAClD,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;QACtE,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,CAAC;IACD,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,KAAK;IACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,8DAA8D;QAC5D,WAAW;QACX,yCAAyC;QACzC,YAAY;QACZ,OAAO,WAAW,yCAAyC;QAC3D,OAAO,WAAW,0DAA0D;QAC5E,aAAa;QACb,8EAA8E;QAC9E,gFAAgF;QAChF,gEAAgE;QAChE,sEAAsE;QACtE,qDAAqD;QACrD,8CAA8C,CACjD,CAAC;AACJ,CAAC;AAWD,SAAS,SAAS,CAAC,IAAI;IACrB,MAAM,IAAI,GAAuB;QAC/B,UAAU,EAAE,GAAG;QACf,OAAO,EAAE,IAAI;QACb,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,IAAA,iBAAS,EAAC,IAAI,CAAC;KACtB,CAAC;IACF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,KAAK,eAAe,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAAE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;aACjE,IAAI,CAAC,KAAK,YAAY,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;aAChE,IAAI,CAAC,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;aACvC,IAAI,CAAC,KAAK,UAAU;YAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;aACzC,IAAI,CAAC,KAAK,QAAQ;YAAE,SAAS;aAC7B,IAAI,CAAC,KAAK,UAAU,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,MAAM;YAAE,CAAC,EAAE,CAAC;aACpD,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YACtC,KAAK,EAAE,CAAC;YACR,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;YACjD,KAAK,EAAE,CAAC;YACR,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAa,WAAY,SAAQ,qBAAW;IACnC,OAAO;QACZ,IAAI,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACrB,qEAAqE;QACrE,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS;YAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAChD,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM;YAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAE7C,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,EAAE,GAAG,IAAA,eAAO,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE9B,IAAI,UAAU,CAAC;QACf,IAAI,CAAC;YACH,UAAU,GAAG,IAAA,gCAAiB,EAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE;gBACnB,IAAA,mBAAK,EAAC,YAAY,EAAE,IAAA,0BAAY,EAAC,GAAG,CAAC,EAAE;oBACrC,GAAG,EAAE,sEAAsE;iBAC5E,CAAC;aACH,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAC9D,4EAA4E;QAC5E,4EAA4E;QAC5E,sBAAsB;QACtB,MAAM,IAAI,GAAG;YACX,YAAY,EAAE,WAAW,CAAC,UAAU,CAAC;YACrC,aAAa,EAAE,OAAO;gBACpB,CAAC,CAAC,cAAc,OAAO,GAAG;gBAC1B,CAAC,CAAC,2EAA2E;YAC/E,YAAY,EAAE,OAAO;gBACnB,CAAC,CAAC,GAAG,OAAO,oCAAoC;gBAChD,CAAC,CAAC,kCAAkC;SACvC,CAAC;QAEF,MAAM,OAAO,GAAG;YACd;gBACE,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,IAAA,yBAAc,EAClB,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,yBAAyB,CAAC,EAAE,MAAM,CAAC,EACxE,IAAI,CACL;aACF;YACD;gBACE,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,IAAA,yBAAc,EAClB,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,sBAAsB,CAAC,EAAE,MAAM,CAAC,EACrE,IAAI,CACL;aACF;SACF,CAAC;QAEF,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,EAAE,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE;gBACvE,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;oBAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,QAAQ,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CACtE,CAAC;oBACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;oBAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC7B,CAAC;YACH,CAAC,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,OAAO;aACrB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAClB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAChE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACvC,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,UAAU,EAAE,UAAU,EAAE,EAAE;gBACrC,IAAA,mBAAK,EAAC,uBAAuB,EAAE,oBAAoB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE;oBACxE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;oBACnB,GAAG,EAAE,2EAA2E;iBACjF,CAAC;aACH,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,EAAE,CAAC;QACnB,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;YAC5C,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACrD,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACxC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAED,uEAAuE;QACvE,4EAA4E;QAC5E,MAAM,aAAa,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;QAErD,MAAM,MAAM,GAAG;YACb,IAAA,kBAAI,EAAC,qBAAqB,EAAE,uCAAuC,EAAE;gBACnE,GAAG,EAAE,wFAAwF;aAC9F,CAAC;SACH,CAAC;QACF,IAAI,aAAa;YAAE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;;YAE5C,MAAM,CAAC,IAAI,CACT,IAAA,kBAAI,EACF,yBAAyB,EACzB,gGAAgG,EAChG;gBACE,MAAM,EAAE,gBAAgB;gBACxB,GAAG,EAAE,iIAAiI;aACvI,CACF,CACF,CAAC;QAEJ,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CACT,IAAA,qBAAO,EACL,wBAAwB,EACxB,2DAA2D,EAC3D;gBACE,MAAM,EAAE,WAAW;gBACnB,GAAG,EAAE,wJAAwJ;aAC9J,CACF,CACF,CAAC;QACJ,CAAC;QAED,EAAE,CAAC,IAAI,CACL;YACE,UAAU;YACV,OAAO;YACP,KAAK,EAAE,OAAO;YACd,MAAM;SACP,EACD,GAAG,EAAE;YACH,KAAK,MAAM,IAAI,IAAI,OAAO;gBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,IAAI,IAAI,CAAC,CAAC;YAC9E,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,mCAAmC;gBACjC,0CAA0C,OAAO,CAAC,CAAC,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC,CAAC,6BAA6B,IAAI;gBACvG,0EAA0E;gBAC1E,mBAAmB;gBACnB,mFAAmF;gBACnF,uFAAuF;gBACvF,qFAAqF,CACxF,CAAC;QACJ,CAAC,CACF,CAAC;IACJ,CAAC;CACF;AA/ID,kCA+IC;AAED,gFAAgF;AAEhF,gFAAgF;AACnE,QAAA,iBAAiB,GAAG,aAAa,CAAC;AAClC,QAAA,kBAAkB,GAAG,oCAAoC,yBAAiB,EAAE,CAAC;AAE1F;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAgB,kBAAkB,CAAC,UAAkB;IACnD,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE9F,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,0BAAkB,CAAC,EAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,QAAQ,KAAK,EAAE,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACzE,EAAE,CAAC,cAAc,CACf,cAAc,EACd,GAAG,SAAS,mEAAmE;YAC7E,4EAA4E;YAC5E,6CAA6C;YAC7C,GAAG,0BAAkB,IAAI,EAC3B,MAAM,CACP,CAAC;IACJ,CAAC;IAED,8EAA8E;IAC9E,kEAAkE;IAClE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,uBAAuB,CAAC,CAAC;IACzE,MAAM,SAAS,GAAG,CAAC,GAAW,EAAE,KAAa,EAAE,EAAE,CAC/C,IAAA,8BAAS,EAAC,KAAK,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IAEnF,yEAAyE;IACzE,EAAE;IACF,6DAA6D;IAC7D,EAAE;IACF,yEAAyE;IACzE,8EAA8E;IAC9E,mEAAmE;IACnE,4EAA4E;IAC5E,4EAA4E;IAC5E,6EAA6E;IAC7E,kDAAkD;IAClD,wDAAwD;IACxD,EAAE;IACF,4EAA4E;IAC5E,6EAA6E;IAC7E,MAAM,UAAU,GAAG,SAAS,CAC1B,SAAS,yBAAiB,SAAS,EACnC,QAAQ,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,WAAW,CAChD,CAAC;IAEF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,IAAA,8BAAS,EAAC,KAAK,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,yBAAiB,OAAO,CAAC,EAAE;YAC3F,QAAQ,EAAE,MAAM;SACjB,CAAC,CAAC;QACH,OAAO,IAAA,qBAAO,EACZ,6BAA6B,EAC7B,iEAAiE,EACjE;YACE,MAAM,EAAE,gBAAgB;YACxB,GAAG,EACD,sCAAsC;gBACtC,sBAAsB,yBAAiB,iBAAiB,YAAY,cAAc;gBAClF,mEAAmE;gBACnE,uCAAuC;SAC1C,CACF,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,SAAS,yBAAiB,OAAO,EAAE,gCAAgC,CAAC,CAAC;IAC/E,OAAO,IAAI,CAAC;AACd,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM;IAAE,IAAI,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC"}

package/dist/scripts/harness/prompt.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * Builds the structured prompt handed to a coding agent for one requirement.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildPrompt = buildPrompt;
+const instructions_1 = require("../change/instructions");
+const DiskHarnessConfigRepository_1 = require("../../packages/core/src/infrastructure/DiskHarnessConfigRepository");
+const GenerateAgentPromptUseCase_1 = require("../../packages/core/src/application/GenerateAgentPromptUseCase");
+function buildPrompt(req, projectDir, opts = {}) {
+    const repo = new DiskHarnessConfigRepository_1.DiskHarnessConfigRepository();
+    const useCase = new GenerateAgentPromptUseCase_1.GenerateAgentPromptUseCase(repo);
+    return useCase.execute(req, projectDir, {
+        ...opts,
+        stageRules: instructions_1.STAGES?.apply?.rules,
+    });
+}
+//# sourceMappingURL=prompt.js.map

package/dist/scripts/harness/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../scripts/harness/prompt.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAYH,kCAYC;AAtBD,yDAAgD;AAChD,oHAAiH;AACjH,+GAA4G;AAQ5G,SAAgB,WAAW,CACzB,GAA4B,EAC5B,UAAkB,EAClB,OAAsB,EAAE;IAExB,MAAM,IAAI,GAAG,IAAI,yDAA2B,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,uDAA0B,CAAC,IAAI,CAAC,CAAC;IAErD,OAAO,OAAO,CAAC,OAAO,CAAC,GAAwB,EAAE,UAAU,EAAE;QAC3D,GAAG,IAAI;QACP,UAAU,EAAE,qBAAM,EAAE,KAAK,EAAE,KAAK;KACjC,CAAC,CAAC;AACL,CAAC"}