@warpgogol/forge 0.22.0 → 0.24.0

package/dist/os/spec/live-spec-validate.js

@@ -0,0 +1,140 @@
+/*
+<MODULE_CONTRACT>
+<purpose>spec.live.validate handler — validates all living specs in docs/specs/live/
+with rules V-LS-01..05 (RFC-0711).</purpose>
+<non-goals>
+  <item>Do not merge or list — use spec.live.merge / spec.live.list.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0711: initial spec.live.validate handler with V-LS-01..05 rules.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs/promises";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import YAML from "yaml";
+import { listRfcFiles, readAndParseRfc } from "../rfc/frontmatter-io.js";
+import { RFC_DIR } from "../rfc/types.js";
+const LIVE_SPECS_DIR = "docs/specs/live";
+const REQUIRED_FM_FIELDS = ["domain", "title", "lastMergedRfc", "updatedAt", "createdAt", "history"];
+export async function runSpecLiveValidate(_input, context) {
+    const { workspaceRoot, logger, outputFormat } = context;
+    const liveSpecsDir = path.join(workspaceRoot, LIVE_SPECS_DIR);
+    const rfcDir = path.join(workspaceRoot, RFC_DIR);
+    const violations = [];
+    let specsChecked = 0;
+    const domains = new Set();
+    const archivedRfcIds = new Set();
+    const rfcFiles = await listRfcFiles(rfcDir);
+    for (const file of rfcFiles) {
+        const parsed = await readAndParseRfc(rfcDir, file);
+        if (parsed) {
+            const id = String(parsed.parsed.frontmatter["id"] ?? "").trim();
+            const status = String(parsed.parsed.frontmatter["status"] ?? "").trim();
+            if (id && (status === "implemented" || status === "rejected" || status === "superseded")) {
+                archivedRfcIds.add(id);
+            }
+        }
+    }
+    if (!existsSync(liveSpecsDir)) {
+        const result = {
+            command: "spec.live.validate",
+            status: "pass",
+            violations: [],
+            specsChecked: 0,
+        };
+        if (outputFormat === "pretty") {
+            logger.info("spec.live.validate: no living specs directory — pass (empty)");
+        }
+        return {
+            data: result,
+            exitCode: 0,
+            summary: "spec.live.validate: 0 living specs — pass",
+        };
+    }
+    const files = await fs.readdir(liveSpecsDir);
+    const specFiles = files.filter((f) => f.endsWith(".md") && f !== "README.md");
+    for (const file of specFiles) {
+        specsChecked++;
+        const filePath = path.join(liveSpecsDir, file);
+        const content = await fs.readFile(filePath, "utf-8");
+        const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+        if (!match) {
+            violations.push({ rule: "V-LS-01", message: `${file}: no valid frontmatter block`, domain: file });
+            continue;
+        }
+        const fm = (YAML.parse(match[1]) ?? {});
+        const domain = String(fm["domain"] ?? "");
+        for (const field of REQUIRED_FM_FIELDS) {
+            if (!(field in fm) || fm[field] === undefined || fm[field] === null) {
+                violations.push({
+                    rule: "V-LS-01",
+                    message: `${file}: missing required field "${field}"`,
+                    domain,
+                });
+            }
+        }
+        if (domain && file !== `${domain}.md`) {
+            violations.push({
+                rule: "V-LS-02",
+                message: `${file}: domain "${domain}" does not match filename`,
+                domain,
+            });
+        }
+        const lastMergedRfc = String(fm["lastMergedRfc"] ?? "");
+        if (lastMergedRfc && !archivedRfcIds.has(lastMergedRfc)) {
+            violations.push({
+                rule: "V-LS-03",
+                message: `${file}: lastMergedRfc "${lastMergedRfc}" is not an archived RFC`,
+                domain,
+            });
+        }
+        const history = Array.isArray(fm["history"]) ? fm["history"] : [];
+        for (const entry of history) {
+            if (entry.rfc && !archivedRfcIds.has(entry.rfc)) {
+                violations.push({
+                    rule: "V-LS-04",
+                    message: `${file}: history entry "${entry.rfc}" is not an archived RFC`,
+                    domain,
+                });
+            }
+        }
+        if (domain) {
+            if (domains.has(domain)) {
+                violations.push({
+                    rule: "V-LS-05",
+                    message: `duplicate domain "${domain}" found in multiple files`,
+                    domain,
+                });
+            }
+            domains.add(domain);
+        }
+    }
+    const hasFailures = violations.length > 0;
+    const result = {
+        command: "spec.live.validate",
+        status: hasFailures ? "fail" : "pass",
+        violations,
+        specsChecked,
+    };
+    if (outputFormat === "pretty") {
+        if (hasFailures) {
+            logger.error(`spec.live.validate: ${violations.length} violation(s) across ${specsChecked} spec(s)`);
+            for (const v of violations) {
+                logger.error(`  ${v.rule}: ${v.message}`);
+            }
+        }
+        else {
+            logger.success(`spec.live.validate: all ${specsChecked} living spec(s) pass`);
+        }
+    }
+    return {
+        data: result,
+        exitCode: hasFailures ? 1 : 0,
+        summary: hasFailures
+            ? `spec.live.validate: ${violations.length} violation(s)`
+            : `spec.live.validate: ${specsChecked} spec(s) — pass`,
+    };
+}
+//# sourceMappingURL=live-spec-validate.js.map

package/dist/os/spec/live-spec-validate.js.map

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

package/dist/os/spec/spec.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spec.module.d.ts","sourceRoot":"","sources":["../../../os/spec/spec.module.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,eAAO,MAAM,eAAe,EAAE,WA2D7B,CAAC"}
+{"version":3,"file":"spec.module.d.ts","sourceRoot":"","sources":["../../../os/spec/spec.module.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,eAAO,MAAM,eAAe,EAAE,WAsH7B,CAAC"}

package/dist/os/spec/spec.module.js

@@ -1,6 +1,6 @@
 /*
 <MODULE_CONTRACT>
-<purpose>Register the forge spec module — spec.validate (RFC-0394), spec.status + spec.materialize (RFC-0396).</purpose>
+<purpose>Register the forge spec module — spec.validate (RFC-0394), spec.status + spec.materialize (RFC-0396), spec.live.merge/list/show/validate (RFC-0711).</purpose>
 <non-goals>
   <item>Do not implement skill logic — skills live in skills/.</item>
 </non-goals>
@@ -8,15 +8,20 @@
 <CHANGE_SUMMARY>
   <item>RFC-0394: initial forgeSpecModule registering spec.validate.</item>
   <item>RFC-0396: added spec.status and spec.materialize commands.</item>
+  <item>RFC-0711: added spec.live.merge, spec.live.list, spec.live.show, spec.live.validate commands.</item>
 </CHANGE_SUMMARY>
 */
 export const forgeSpecModule = {
     name: "forge-spec",
-    version: "0.1.0",
+    version: "0.2.0",
     async register(registry) {
         const { runSpecValidate } = await import("./spec-validate.js");
         const { runSpecStatus } = await import("./spec-status.js");
         const { runSpecMaterialize } = await import("./spec-materialize.js");
+        const { runSpecLiveMerge } = await import("./live-spec-merge.js");
+        const { runSpecLiveList } = await import("./live-spec-list.js");
+        const { runSpecLiveShow } = await import("./live-spec-show.js");
+        const { runSpecLiveValidate } = await import("./live-spec-validate.js");
         registry.registerCommand({
             name: "spec.validate",
             description: "Validate vendored spec packages under docs/specs/. " +
@@ -62,6 +67,53 @@ export const forgeSpecModule = {
             },
             execute: runSpecMaterialize,
         });
+        registry.registerCommand({
+            name: "spec.live.merge",
+            description: "Merge deltas from an implemented RFC's ## Design section into a living feature spec " +
+                "under docs/specs/live/<domain>.md. Requires --id=<RFC-XXXX>. " +
+                "Domain is auto-derived from packagesImpacted[0] when liveSpec: true, or uses " +
+                "the string value when liveSpec: <domain>. " +
+                "All-or-nothing: aborts on any heading conflict without writing. " +
+                "Use --dry-run to preview deltas without writing.",
+            scope: "workspace",
+            mutatesState: true,
+            writes: ["docs/specs/live/*.md"],
+            reads: ["docs/rfcs/**/*.md", "docs/specs/live/*.md"],
+            flags: {
+                id: { kind: "string", required: true, description: "RFC id to merge (e.g. RFC-0711)." },
+                "dry-run": { kind: "boolean", description: "Preview deltas without writing files." },
+            },
+            execute: runSpecLiveMerge,
+        });
+        registry.registerCommand({
+            name: "spec.live.list",
+            description: "List all living feature specs in docs/specs/live/. " +
+                "Returns domain, title, lastMergedRfc, updatedAt, and historyCount for each spec.",
+            scope: "workspace",
+            reads: ["docs/specs/live/*.md"],
+            execute: runSpecLiveList,
+        });
+        registry.registerCommand({
+            name: "spec.live.show",
+            description: "Show a single living feature spec by domain. " +
+                "Requires --domain=<name>. Returns full frontmatter and body content.",
+            scope: "workspace",
+            reads: ["docs/specs/live/*.md"],
+            flags: {
+                domain: { kind: "string", required: true, description: "Domain name (filename without .md)." },
+            },
+            execute: runSpecLiveShow,
+        });
+        registry.registerCommand({
+            name: "spec.live.validate",
+            description: "Validate all living feature specs in docs/specs/live/. " +
+                "Checks V-LS-01 (frontmatter), V-LS-02 (domain/filename match), " +
+                "V-LS-03 (lastMergedRfc is archived), V-LS-04 (history entries are archived), " +
+                "V-LS-05 (no duplicate domains).",
+            scope: "workspace",
+            reads: ["docs/specs/live/*.md", "docs/rfcs/**/*.md"],
+            execute: runSpecLiveValidate,
+        });
     },
 };
 //# sourceMappingURL=spec.module.js.map

package/dist/os/spec/spec.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"spec.module.js","sourceRoot":"","sources":["../../../os/spec/spec.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AAIF,MAAM,CAAC,MAAM,eAAe,GAAgB;IAC1C,IAAI,EAAE,YAAY;IAClB,OAAO,EAAE,OAAO;IAChB,KAAK,CAAC,QAAQ,CAAC,QAAQ;QACrB,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAC/D,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;QAC3D,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;QAErE,QAAQ,CAAC,eAAe,CAAC;YACvB,IAAI,EAAE,eAAe;YACrB,WAAW,EACT,qDAAqD;gBACrD,kEAAkE;gBAClE,gFAAgF;gBAChF,4CAA4C;YAC9C,KAAK,EAAE,WAAW;YAClB,KAAK,EAAE;gBACL,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+BAA+B;iBAC7C;aACF;YACD,KAAK,EAAE,CAAC,iBAAiB,CAAC;YAC1B,OAAO,EAAE,eAAe;SACzB,CAAC,CAAC;QAEH,QAAQ,CAAC,eAAe,CAAC;YACvB,IAAI,EAAE,aAAa;YACnB,WAAW,EACT,4CAA4C;gBAC5C,sFAAsF;YACxF,KAAK,EAAE,WAAW;YAClB,KAAK,EAAE;gBACL,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,gCAAgC;iBAC9C;aACF;YACD,KAAK,EAAE,CAAC,iBAAiB,EAAE,mBAAmB,CAAC;YAC/C,OAAO,EAAE,aAAa;SACvB,CAAC,CAAC;QAEH,QAAQ,CAAC,eAAe,CAAC;YACvB,IAAI,EAAE,kBAAkB;YACxB,WAAW,EACT,mEAAmE;gBACnE,qGAAqG;YACvG,KAAK,EAAE,WAAW;YAClB,YAAY,EAAE,IAAI;YAClB,MAAM,EAAE,CAAC,oBAAoB,EAAE,8BAA8B,CAAC;YAC9D,KAAK,EAAE,CAAC,iBAAiB,EAAE,mBAAmB,CAAC;YAC/C,KAAK,EAAE;gBACL,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,8BAA8B,EAAE;gBACrF,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2DAA2D,EAAE;gBAClG,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mDAAmD,EAAE;aAC5F;YACD,OAAO,EAAE,kBAAkB;SAC5B,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}
+{"version":3,"file":"spec.module.js","sourceRoot":"","sources":["../../../os/spec/spec.module.ts"],"names":[],"mappings":"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"}

package/dist/src/index.d.ts

@@ -29,4 +29,5 @@ export { forgeAdrModule } from "../os/adr/adr.module.ts";
 export { forgePlanModule } from "../os/plan/plan.module.ts";
 export { forgeAuditModule } from "../os/audit/audit.module.ts";
 export { forgeMissionModule } from "../os/mission/mission.module.ts";
+export { forgeExplorationModule } from "../os/exploration/exploration.module.ts";
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/src/index.js

@@ -49,4 +49,5 @@ export { forgeAdrModule } from "../os/adr/adr.module.js";
 export { forgePlanModule } from "../os/plan/plan.module.js";
 export { forgeAuditModule } from "../os/audit/audit.module.js";
 export { forgeMissionModule } from "../os/mission/mission.module.js";
+export { forgeExplorationModule } from "../os/exploration/exploration.module.js";
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AA6BF,sBAAsB;AACtB,OAAO,EACL,eAAe,EAEf,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,8BAA8B,EAG9B,WAAW,EACX,YAAY,EACZ,UAAU,EAEV,QAAQ,GACT,MAAM,kBAAkB,CAAC;AAK1B,eAAe;AACf,OAAO,EAAE,sBAAsB,EAAyB,MAAM,mBAAmB,CAAC;AAElF,iBAAiB;AACjB,OAAO,EAAE,YAAY,EAAwB,MAAM,eAAe,CAAC;AAEnE,0BAA0B;AAC1B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,0BAA0B,EAC1B,aAAa,EACb,eAAe,EACf,uBAAuB,EACvB,qBAAqB,GAMtB,MAAM,0BAA0B,CAAC;AAElC,sCAAsC;AACtC,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,GAGZ,MAAM,6BAA6B,CAAC;AAErC,mCAAmC;AACnC,OAAO,EACL,8BAA8B,EAC9B,qBAAqB,EACrB,0BAA0B,EAC1B,sBAAsB,EACtB,0BAA0B,EAC1B,oBAAoB,GAKrB,MAAM,8BAA8B,CAAC;AAEtC,8BAA8B;AAC9B,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,GAQzB,MAAM,sBAAsB,CAAC;AAE9B,aAAa;AACb,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,kCAAkC;AAClC,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEzF,aAAa;AACb,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAStE,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAChG,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,+BAA+B,CAAC;AAEvC,aAAa;AACb,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AA6BF,sBAAsB;AACtB,OAAO,EACL,eAAe,EAEf,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,8BAA8B,EAG9B,WAAW,EACX,YAAY,EACZ,UAAU,EAEV,QAAQ,GACT,MAAM,kBAAkB,CAAC;AAK1B,eAAe;AACf,OAAO,EAAE,sBAAsB,EAAyB,MAAM,mBAAmB,CAAC;AAElF,iBAAiB;AACjB,OAAO,EAAE,YAAY,EAAwB,MAAM,eAAe,CAAC;AAEnE,0BAA0B;AAC1B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,0BAA0B,EAC1B,aAAa,EACb,eAAe,EACf,uBAAuB,EACvB,qBAAqB,GAMtB,MAAM,0BAA0B,CAAC;AAElC,sCAAsC;AACtC,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,GAGZ,MAAM,6BAA6B,CAAC;AAErC,mCAAmC;AACnC,OAAO,EACL,8BAA8B,EAC9B,qBAAqB,EACrB,0BAA0B,EAC1B,sBAAsB,EACtB,0BAA0B,EAC1B,oBAAoB,GAKrB,MAAM,8BAA8B,CAAC;AAEtC,8BAA8B;AAC9B,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,GAQzB,MAAM,sBAAsB,CAAC;AAE9B,aAAa;AACb,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,kCAAkC;AAClC,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEzF,aAAa;AACb,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAStE,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAChG,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,+BAA+B,CAAC;AAEvC,aAAa;AACb,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC"}

package/os/rfc/rfc-0000-template.md

@@ -40,6 +40,11 @@ satisfies: []
 # Values: minor (Breaks-B, requires migrator), patch (safe), none (prose-only),
 # major (architectural, manually reserved). Default: patch.
 versionBump: patch
+# RFC-0711: Declares that this RFC contributes to a living feature spec
+# under docs/specs/live/<domain>.md. When true, domain is auto-derived from
+# packagesImpacted[0]. When a string, used as explicit domain override.
+# Absent or false means no living spec merge occurs.
+# liveSpec: true
 commands:
   proposed: []
   added: []

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warpgogol/forge",
-  "version": "0.22.0",
+  "version": "0.24.0",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",
@@ -116,6 +116,14 @@
     "./os/mission-module": {
       "types": "./dist/os/mission/mission.module.d.ts",
       "default": "./dist/os/mission/mission.module.js"
+    },
+    "./os/exploration": {
+      "types": "./dist/os/exploration/index.d.ts",
+      "default": "./dist/os/exploration/index.js"
+    },
+    "./os/exploration-module": {
+      "types": "./dist/os/exploration/exploration.module.d.ts",
+      "default": "./dist/os/exploration/exploration.module.js"
     }
   },
   "files": [

package/skills/_shared/fo-pipeline-conventions.md

@@ -27,6 +27,22 @@ Stage only the files this skill produces or modifies. Another agent may be worki
 - **RFC pipeline**: create → audit → enhance → plan → implement (includes review → fix)
 - **ADR pipeline**: create → implement (includes review → fix)
 
+## Minimality ladder
+
+Before writing implementation code, climb the minimality ladder. Stop at the first rung that holds — that is your implementation. The ladder runs after you understand the problem (read the code, trace the flow), not instead of it.
+
+1. **Does this need to exist?** → no: skip it (YAGNI)
+2. **Already in this codebase?** → reuse it, don't rewrite
+3. **Stdlib does it?** → use it
+4. **Native platform feature?** → use it (e.g. `<input type="date">` instead of a date picker library)
+5. **Installed dependency?** → use it
+6. **One line?** → one line
+7. **Only then**: write the minimum that works
+
+Lazy about the solution, never about reading. Lazy, not negligent: trust-boundary validation, data-loss handling, security, and accessibility are never on the chopping block — they are part of "the minimum that works."
+
+The ladder is a pre-coding decision tool, not a post-hoc review checklist. It determines the implementation approach before the first edit. During `fo-review`, the reviewer checks whether the author climbed the ladder — flagging cases where a library was installed for something stdlib/native/existing-dep already provides.
+
 ## Forward-only discipline
 
 The ecosystem is forward-only. No backward compatibility layers, no shims, no dual-paths. Legacy code paths are deleted, not maintained behind a flag. Deprecation means removal in the same change, not an indefinite grace period.
@@ -118,6 +134,14 @@ After completing implementation work, the operator may run a three-step session-
 
 Most sessions need only `fo-doc-audit`. `fo-session-retro` is valuable after debugging sessions, exploratory work, or when non-obvious behaviors were discovered. `fo-handoff` is needed when work is incomplete and another agent will continue.
 
+### Session-end trigger phrases (BLOCKED GATE — NON-NEGOTIABLE)
+
+When the operator says any session-end trigger phrase (e.g. "Завершаем сессию", "Завершаем эту сессию", "Заканчиваем сессию", "Завершить сессию", "End session", "Wrap up", "Session end", "/session-end"), the agent's response is **BLOCKED** — no closing summary, no ad-hoc "session complete" message, no closing block is permitted until `fo-session-retro` is invoked via the `skill` tool and completes.
+
+**The agent MUST NOT produce any session-end output (summary, closing block, "session complete" message) before `fo-session-retro` is invoked and its report is presented. Producing a closing summary without running `fo-session-retro` is a CONTRACT VIOLATION.**
+
+The `fo-session-retro` skill IS the session-end protocol — it runs transcript save, temp cleanup, docs.archive, clean tree check, RFC verification, insight triage, and produces the closing block. Do not substitute it with a manual summary. The closing block comes from `fo-session-retro`, not from the agent directly.
+
 ## Context checkpoint between batch items
 
 When the orchestrator skill processes multiple documents (>=2), perform a context checkpoint after completing one document and before starting the next:

package/skills/_shared/fo-session-summary.md

@@ -2,6 +2,12 @@
 
 Reference file for all `fo-*` skills. Every `fo-*` skill MUST end its session by presenting the closing block defined here. This is not optional — it is the mandatory final output before the skill stops.
 
+## Session-end protocol (BLOCKED GATE — NON-NEGOTIABLE)
+
+When the operator says any session-end trigger phrase (e.g. "Завершаем сессию", "End session", "Wrap up", "/session-end"), the agent MUST invoke `fo-session-retro` via the `skill` tool BEFORE producing any closing block or session-end output. The closing block defined below is produced by `fo-session-retro` as part of its report — the agent MUST NOT produce a closing block directly in response to a session-end trigger phrase. See `_shared/fo-pipeline-conventions.md` §Session-end trigger phrases for the full protocol.
+
+**Producing a closing block without first invoking `fo-session-retro` is a CONTRACT VIOLATION.**
+
 ## When to emit
 
 The closing block is emitted **once**, at the very end of the skill's execution — after all work is done, after all commits, after any batch summaries. It is the last thing the operator sees.

package/skills/fo/fo-design-summit/SKILL.md

@@ -0,0 +1,240 @@
+---
+name: fo-design-summit
+description: Simulate a multi-persona design discussion for complex RFCs. Each persona reviews from its professional perspective and raises concerns. Optional, invoked for high-risk architectural RFCs.
+invocation: user
+category: fo
+concerns: document-only
+dependsOn: ['my-preferences', 'fo-idea-audit']
+languagePolicy: ref(PREFERENCES.md)
+bindings:
+  requires: [paths.invariantsFile]
+  optional: []
+triggers: ["design summit", "multi-persona review", "party mode"]
+---
+
+# Design Summit
+
+Before starting, read `PREFERENCES.md` at the repository root. If the file is missing or `aiLanguage` is unset, ask the operator once and create the file using the `my-preferences` skill semantics.
+
+See `_shared/fo-pipeline-conventions.md` §Language policy.
+
+A multi-persona design review for complex RFCs. The summit simulates five professional perspectives — Architect, Security Engineer, QA Engineer, Product Manager, and Developer Advocate — to surface issues that a single-perspective review misses. Each persona reviews the RFC from its professional lens and raises concerns. The operator sees all perspectives and makes the final decision.
+
+The summit is **optional** — invoked manually by the operator or suggested by `fo-idea-plan` for RFCs that meet complexity criteria. It is not part of the default pipeline.
+
+The summit is `concern: document-only` — it writes a summit report to `docs/summits/` and does not modify the RFC or any source code.
+
+## Process
+
+### 1. Identify the RFC
+
+The user may provide:
+
+- **A single RFC**: `RFC-XXXX`, a filename, or a path.
+- **Nothing**: if an RFC file is open in the IDE, use it. Otherwise, ask.
+
+### 2. Prerequisite checks
+
+Before running the summit, perform these checks **in order**:
+
+1. **Prefix check** — if the id starts with `ADR-`, stop with message: `ADR-XXXX is an ADR. Design summits are for RFCs only. ADRs use the accepted-decision fast path.`
+2. **RFC file exists** — look for `docs/rfcs/rfc-XXXX-*.md`. If no file is found, stop with message: `RFC-XXXX not found in docs/rfcs/.`
+3. **Terminal status check** — read the RFC's `status` frontmatter. If the status is `implemented`, `rejected`, or `superseded`, stop with message: `RFC-XXXX is <status> (terminal). Terminal RFCs cannot be reviewed in a summit.`
+
+If all checks pass, proceed to step 3.
+
+### 3. Read the RFC and related context
+
+Read the target RFC file and its related context:
+
+- `ref(forge.yaml bindings.paths.invariantsFile)` — all DNA invariants referenced in the RFC's `satisfies[]` or `related[]`.
+- Each RFC listed in `amends[]`, `supersedes[]`, `related[]` — read enough to understand what this RFC builds on or changes.
+- The closest `AGENTS.md` for the RFC's scope.
+
+### 4. Read the audit report (if available)
+
+Look for `docs/audits/audit-rfc-XXXX-*.md`. If an audit report exists, read it to avoid duplicating findings. The summit complements the audit — it does not repeat it.
+
+If no audit report exists, proceed without it. Note this in the summit report: persona findings may overlap with future audit findings.
+
+### 5. Run each persona
+
+For each of the five personas, the agent:
+
+1. Adopts the persona's perspective and review focus.
+2. Reads the RFC from that perspective.
+3. Produces a persona report with findings (concerns, questions, recommendations).
+
+#### Persona: Architect
+
+**Focus:** Structural integrity, DNA alignment, coupling.
+
+**Key questions:**
+
+- Does this create hidden dependencies between packages or services?
+- Which DNA invariants are affected? Does the RFC explain how it enforces or protects each one?
+- Will this decision be reversible? If not, is the irreversibility justified?
+- Does the RFC propose a new package, command, or lifecycle that could be a flag on an existing one?
+
+#### Persona: Security Engineer
+
+**Focus:** Attack surface, data exposure, trust boundaries.
+
+**Key questions:**
+
+- What new trust boundaries does this create?
+- Are there unauthenticated paths to sensitive data?
+- Does this leak sensitive data in logs, error messages, or generated artifacts?
+- If the RFC touches persistence, does it introduce cookies or client-side storage outside the established policy?
+
+#### Persona: QA Engineer
+
+**Focus:** Testability, failure modes, edge cases.
+
+**Key questions:**
+
+- How do we test this? What is the test seam — unit, integration, or both?
+- What are the failure modes? What happens under partial failure?
+- Does the RFC consider empty states (new app with no content, package with no manifests)?
+- Are acceptance criteria checkable by an agent or human?
+
+#### Persona: Product Manager
+
+**Focus:** User impact, rollout risk, scope.
+
+**Key questions:**
+
+- Does this solve the stated problem? Is the problem statement grounded in a real user need?
+- What is the rollout impact on existing users? Is there a migration path?
+- Is the scope right — too broad, too narrow, or correctly bounded?
+- Are `nonGoals` explicit and meaningful?
+
+#### Persona: Developer Advocate
+
+**Focus:** Agent clarity, onboarding, documentation.
+
+**Key questions:**
+
+- Can a new agent understand and implement this RFC without external context?
+- Is the RFC self-contained, or does it reference implicit assumptions?
+- Are there terms or concepts that need a glossary entry?
+- Does the RFC's `Implementation notes for agents` section provide explicit behavioral rules?
+
+### 6. Synthesize
+
+Present all persona reports in a single summit document, highlighting:
+
+- **Consensus findings** — concerns raised by 2+ personas (high priority).
+- **Unique findings** — concerns raised by a single persona (medium priority).
+- **No concerns** — personas that found no issues (confidence signal).
+
+Deduplicate overlapping concerns. When two personas raise the same issue from different angles, merge them into a consensus finding.
+
+### 7. Persist the summit report
+
+Write `docs/summits/summit-<rfc-id>.md` with the full discussion.
+
+#### Summit report format
+
+```markdown
+---
+rfc: RFC-XXXX
+createdAt: YYYY-MM-DD
+personas: [architect, security, qa, pm, dev-advocate]
+consensusFindings: <count>
+uniqueFindings: <count>
+---
+
+# Design Summit: RFC-XXXX
+
+## Architect
+
+### Findings
+- **A1 (concern):** <finding text>
+- **A2 (question):** <finding text>
+
+### No concerns
+- <what the architect found well-designed>
+
+## Security Engineer
+
+### Findings
+- **S1 (concern):** <finding text>
+
+## QA Engineer
+
+### Findings
+- **Q1 (concern):** <finding text>
+
+## Product Manager
+
+### Findings
+- **P1 (concern):** <finding text>
+
+## Developer Advocate
+
+### Findings
+- **D1 (question):** <finding text>
+
+## Consensus findings
+
+- **A1 + D1 (2 personas):** <merged finding and recommendation>
+
+## Recommendation
+
+<proceed to acceptance | revise the RFC | run fo-explore for unresolved questions>
+```
+
+The report must include the disclaimer: "No findings does not mean no issues — it means no issues were found from these five perspectives."
+
+### 8. Suggest actions
+
+Recommend whether to:
+
+- **Proceed to acceptance** — if no consensus findings and unique findings are minor.
+- **Revise the RFC** — if consensus findings or significant unique findings exist. Route through `fo-idea-enhance` as audit-style findings.
+- **Run `fo-explore`** — if unresolved questions require deeper exploration before revision.
+
+### 9. Commit
+
+Commit the summit report. This is **mandatory** — the report must be committed, not left in the working tree.
+
+Commit message format:
+
+```txt
+summit: RFC-XXXX <short description>
+
+Multi-persona design summit for RFC-XXXX (<title>). <count> consensus findings, <count> unique findings.
+```
+
+Stage only the summit report file — do not stage unrelated changes.
+
+### 10. Stop
+
+Do not modify the RFC or any other file. Do not run `/fo-idea-enhance` or `/fo-idea-plan` — those are separate skills. Present the summit report and stop. If the user asks to fix findings, suggest running `/fo-idea-enhance`.
+
+## Invocation criteria
+
+`fo-design-summit` is invoked explicitly by the operator or suggested by `fo-idea-plan` when the RFC meets **any** of these criteria:
+
+- `kind: architecture` AND `scope: workspace`
+- `satisfies[]` includes 2+ DNA invariants
+- The RFC introduces a new package, new command family, or new lifecycle
+- The RFC supersedes an implemented RFC
+- The operator explicitly requests it
+
+## Failure modes
+
+- **RFC not found:** The skill errors if the target RFC does not exist.
+- **Audit not run yet:** The skill proceeds without the audit report — persona findings may overlap with future audit findings. The skill notes this in the report.
+- **RFC is too small for a summit:** If the RFC body is less than 500 words, the skill warns that a summit may be overkill and proceeds only if the operator confirms.
+- **Persona findings overlap:** Multiple personas may raise the same concern. The synthesis step deduplicates and marks consensus findings.
+
+## Constraints
+
+- The summit is `concern: document-only` — it must not modify the RFC, source code, or any file except the summit report in `docs/summits/`.
+- **Commit only your own files.** Stage only the summit report. Do not stage unrelated changes. `git add -A` or `git add .` is forbidden.
+- Personas are **simulated** by a single agent in one session. This is not multi-agent infrastructure. Each persona is a perspective shift, not a separate process.
+- The summit report is an informational artifact, not a governance document. It does not block RFC acceptance — the operator decides whether to act on its findings.
+- Summit findings that warrant RFC changes should be routed through `fo-idea-enhance` as audit-style findings, not applied directly by the summit skill.
+- **No pauses for recoverable tool errors.** If a tool call fails with a recoverable error, recover autonomously: split content into smaller writes, use `edit`/`multi_edit`, and retry immediately.