@warpgogol/forge 4.1.6 → 4.2.1

package/dist/os/workflow/workflow.module.js

@@ -0,0 +1,56 @@
+/*
+<MODULE_CONTRACT>
+<purpose>forgeWorkflowModule — registers workflow.lint, workflow.list, and workflow-amend.list commands from forge.</purpose>
+<non-goals>
+  <item>Do not register app-specific workflow commands.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0075: Add workflow command module.</item>
+  <item>RFC-0374: Migrated from packages/os/site-kernel/src/workflow/ to packages/forge/os/workflow/.</item>
+</CHANGE_SUMMARY>
+*/
+export async function createForgeWorkflowModule() {
+    const { runWorkflowLint, runWorkflowList, runWorkflowAmendList } = await import("./handlers.js");
+    return {
+        name: "workflow",
+        version: "0.1.0",
+        runtime: "autonomous",
+        declarations: [],
+        commands: [
+            {
+                name: "workflow.lint",
+                contract: "workflow",
+                rules: [],
+                description: "Validate .agents/workflows AND .agents/workflows-amend markdown frontmatter, command references, " +
+                    "and per-chain phase links (RFC-0075 + RFC-0136).",
+                scope: "workspace",
+                flags: {},
+                supportsAllSites: true,
+                reads: [".agents/workflows/**/*.md", ".windsurf/workflows/**/*.md"],
+                execute: runWorkflowLint,
+            },
+            {
+                name: "workflow.list",
+                description: "List .agents/workflows entries with phase, IO summary, and next workflow (RFC-0075).",
+                scope: "workspace",
+                flags: {},
+                supportsAllSites: true,
+                reads: [".agents/workflows/**/*.md", ".windsurf/workflows/**/*.md"],
+                execute: runWorkflowList,
+            },
+            {
+                name: "workflow-amend.list",
+                description: "List .agents/workflows-amend entries with phase, IO summary, and next workflow (RFC-0136).",
+                scope: "workspace",
+                flags: {},
+                supportsAllSites: true,
+                reads: [".agents/workflows-amend/**/*.md"],
+                execute: runWorkflowAmendList,
+            }
+        ],
+        pipelines: []
+    };
+}
+;
+//# sourceMappingURL=workflow.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.module.js","sourceRoot":"","sources":["../../../os/workflow/workflow.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AAIF,MAAM,CAAC,KAAK,UAAU,yBAAyB;IAC/C,MAAM,EAAE,eAAe,EAAE,eAAe,EAAE,oBAAoB,EAAE,GAC1D,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;IAClC,OAAO;QACP,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE,YAAY;QACnB,YAAY,EAAE,EAAE;QAClB,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,eAAe;gBACrB,QAAQ,EAAE,UAAU;gBACpB,KAAK,EAAE,EAAE;gBACT,WAAW,EACT,mGAAmG;oBACnG,kDAAkD;gBACpD,KAAK,EAAE,WAAW;gBAClB,KAAK,EAAE,EAAE;gBACT,gBAAgB,EAAE,IAAI;gBACtB,KAAK,EAAE,CAAC,2BAA2B,EAAE,6BAA6B,CAAC;gBACnE,OAAO,EAAE,eAAe;aACzB;YACD;gBACE,IAAI,EAAE,eAAe;gBACrB,WAAW,EACT,sFAAsF;gBACxF,KAAK,EAAE,WAAW;gBAClB,KAAK,EAAE,EAAE;gBACT,gBAAgB,EAAE,IAAI;gBACtB,KAAK,EAAE,CAAC,2BAA2B,EAAE,6BAA6B,CAAC;gBACnE,OAAO,EAAE,eAAe;aACzB;YACD;gBACE,IAAI,EAAE,qBAAqB;gBAC3B,WAAW,EACT,4FAA4F;gBAC9F,KAAK,EAAE,WAAW;gBAClB,KAAK,EAAE,EAAE;gBACT,gBAAgB,EAAE,IAAI;gBACtB,KAAK,EAAE,CAAC,iCAAiC,CAAC;gBAC1C,OAAO,EAAE,oBAAoB;aAC9B;SACF;QACD,SAAS,EAAE,EAEV;KAAC,CAAC;AACL,CAAC;AACD,CAAC"}

package/dist/src/cli-output.d.ts

@@ -0,0 +1,5 @@
+import type { ForgeNextStep, CommandRegistry } from "./types.ts";
+export declare function renderNextSteps(steps?: ForgeNextStep[]): string;
+export declare function renderIdeRecommendation(): string;
+export declare function generateHelp(registry: CommandRegistry): string;
+//# sourceMappingURL=cli-output.d.ts.map

package/dist/src/cli-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-output.d.ts","sourceRoot":"","sources":["../../src/cli-output.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEjE,wBAAgB,eAAe,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,GAAG,MAAM,CAQ/D;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CA2B9D"}

package/dist/src/cli-output.js

@@ -0,0 +1,53 @@
+/*
+<MODULE_CONTRACT>
+<purpose>CLI output rendering helpers (RFC-0542) — renderNextSteps,
+renderIdeRecommendation, generateHelp. Pure functions, no I/O, no process.exit.
+Importable by bin/cli.ts and unit tests.</purpose>
+<non-goals>
+  <item>Do not call console.log or process.exit — callers handle output.</item>
+  <item>Do not import from bin/ — this is the portable layer.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0542: initial CLI output rendering helpers — renderNextSteps, renderIdeRecommendation, generateHelp.</item>
+</CHANGE_SUMMARY>
+*/
+export function renderNextSteps(steps) {
+    if (!steps || steps.length === 0)
+        return "";
+    const lines = ["\nNext steps:"];
+    for (const step of steps) {
+        const label = step.kind === "required" ? "[must do]" : "[can do]";
+        lines.push(`  • ${step.action}        ${label}`);
+    }
+    return lines.join("\n");
+}
+export function renderIdeRecommendation() {
+    return "\nRecommended IDE: Windsurf (tested with forge). Other IDEs (VS Code, Cursor)\nwork but are not tested.";
+}
+export function generateHelp(registry) {
+    const commands = registry.listCommands().filter((cmd) => !cmd.hidden);
+    const header = `forge — autonomous project tooling
+
+Usage:
+  forge <command> [args...] [--flags...]
+  forge --help <command>    Show per-command flags and description
+
+Flags:
+  --json              Output results as JSON
+  --dry-run           Show what would happen without making changes
+  --site <name>       Target a specific site/app
+  --version           Show forge version
+  --help              Show this help (or per-command help with --help <command>)
+
+Registered commands (${commands.length}):`;
+    const commandLines = commands
+        .map((cmd) => {
+        const desc = cmd.description.length > 80 ? cmd.description.slice(0, 77) + "..." : cmd.description;
+        const displayName = cmd.name.replace(/^forge\./, "");
+        return `  ${displayName.padEnd(40)} ${desc}`;
+    })
+        .join("\n");
+    return `${header}\n${commandLines}\n`;
+}
+//# sourceMappingURL=cli-output.js.map

package/dist/src/cli-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-output.js","sourceRoot":"","sources":["../../src/cli-output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;EAaE;AAIF,MAAM,UAAU,eAAe,CAAC,KAAuB;IACrD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5C,MAAM,KAAK,GAAG,CAAC,eAAe,CAAC,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC;QAClE,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,WAAW,KAAK,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,yGAAyG,CAAC;AACnH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAyB;IACpD,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtE,MAAM,MAAM,GAAG;;;;;;;;;;;;;uBAaM,QAAQ,CAAC,MAAM,IAAI,CAAC;IAEzC,MAAM,YAAY,GAAG,QAAQ;SAC1B,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACX,MAAM,IAAI,GACR,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC;QACvF,MAAM,WAAW,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACrD,OAAO,KAAK,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;IAC/C,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO,GAAG,MAAM,KAAK,YAAY,IAAI,CAAC;AACxC,CAAC"}

package/dist/src/compass/contract-registry.d.ts

@@ -0,0 +1,7 @@
+import type { ForgeConfig } from "../config/forge-config.ts";
+import type { CompassContractBlockSpec, CompassContractRegistry, CompassContractRegistryEntry } from "./types.ts";
+export declare function getBuiltInSpecs(): CompassContractBlockSpec[];
+export declare function loadContractRegistry(workspaceRoot: string, config?: ForgeConfig): CompassContractRegistry;
+export declare function fileMatchesGlobs(filePath: string, globs: string[]): boolean;
+export declare function findApplicablePackSpecs(registry: CompassContractRegistry, filePath: string): CompassContractRegistryEntry[];
+//# sourceMappingURL=contract-registry.d.ts.map

package/dist/src/compass/contract-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-registry.d.ts","sourceRoot":"","sources":["../../../src/compass/contract-registry.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACvB,4BAA4B,EAC7B,MAAM,YAAY,CAAC;AAqCpB,wBAAgB,eAAe,IAAI,wBAAwB,EAAE,CAE5D;AAED,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,WAAW,GACnB,uBAAuB,CAoDzB;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAG3E;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,uBAAuB,EACjC,QAAQ,EAAE,MAAM,GACf,4BAA4B,EAAE,CAEhC"}

package/dist/src/compass/contract-registry.js

@@ -0,0 +1,112 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Compass contract block registry — loads built-in and pack-declared block specs from forge.plugin.yaml manifests. Declarative data only, no executable hooks (RFC-0943).</purpose>
+<non-goals>
+  <item>Do not execute pack-provided validate() functions — block specs are declarative data interpreted by compass.validate.</item>
+  <item>Do not import from os/ or kernel modules — this is a portable contract module.</item>
+  <item>Do not handle FORBIDDEN_PATTERNS — the negative list stays hardcoded in compass-inventory.ts.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0943: initial contract registry with built-in specs and pack-declared block loading.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs";
+import path from "node:path";
+import { parse as parseYaml } from "yaml";
+import picomatch from "picomatch";
+import { forgePluginManifestSchema } from "../plugin/forge-plugin-manifest.js";
+const BUILT_IN_SPECS = [
+    {
+        blockId: "module-contract",
+        requiredFor: [
+            "packages/**/*.ts",
+            "packages/**/*.tsx",
+            "packages/**/*.astro",
+            "packages/**/*.js",
+            "packages/**/*.mjs",
+            "packages/**/SKILL.md",
+            "services/**/*.ts",
+            "apps/**/*.ts",
+            "apps/**/*.tsx",
+            "apps/**/*.astro",
+        ],
+        requiredTags: [{ name: "purpose", minWords: 10 }, { name: "non-goals" }],
+    },
+    {
+        blockId: "change-summary",
+        requiredFor: [
+            "packages/**/*.ts",
+            "packages/**/*.tsx",
+            "packages/**/*.astro",
+            "packages/**/*.js",
+            "packages/**/*.mjs",
+            "packages/**/SKILL.md",
+            "services/**/*.ts",
+            "apps/**/*.ts",
+            "apps/**/*.tsx",
+            "apps/**/*.astro",
+        ],
+        requiredTags: [],
+    },
+];
+export function getBuiltInSpecs() {
+    return BUILT_IN_SPECS;
+}
+export function loadContractRegistry(workspaceRoot, config) {
+    const pack = [];
+    const seenBlockIds = new Set();
+    if (config?.skillPacks) {
+        for (const skillPack of config.skillPacks) {
+            const packDir = path.resolve(workspaceRoot, skillPack.dir);
+            const manifestPath = path.join(packDir, "forge.plugin.yaml");
+            if (!fs.existsSync(manifestPath))
+                continue;
+            let manifestRaw;
+            try {
+                manifestRaw = fs.readFileSync(manifestPath, "utf-8");
+            }
+            catch {
+                continue;
+            }
+            let manifestParsed;
+            try {
+                manifestParsed = parseYaml(manifestRaw);
+            }
+            catch {
+                continue;
+            }
+            const result = forgePluginManifestSchema.safeParse(manifestParsed);
+            if (!result.success)
+                continue;
+            const manifest = result.data;
+            const blocks = manifest.extensionPoints?.compass?.contract?.blocks;
+            if (!blocks || blocks.length === 0)
+                continue;
+            for (const block of blocks) {
+                if (seenBlockIds.has(block.blockId)) {
+                    throw new Error(`COMPASS-PLUGIN-DUP-01: duplicate blockId "${block.blockId}" declared by pack "${manifest.id}" — already declared by another pack. Each blockId must be unique across all packs.`);
+                }
+                seenBlockIds.add(block.blockId);
+                pack.push({
+                    blockId: block.blockId,
+                    requiredFor: block.requiredFor,
+                    requiredTags: block.requiredTags,
+                    packId: manifest.id,
+                });
+            }
+        }
+    }
+    return {
+        builtIn: BUILT_IN_SPECS,
+        pack,
+    };
+}
+export function fileMatchesGlobs(filePath, globs) {
+    const matchers = globs.map((g) => picomatch(g, { dot: true }));
+    return matchers.some((m) => m(filePath));
+}
+export function findApplicablePackSpecs(registry, filePath) {
+    return registry.pack.filter((spec) => fileMatchesGlobs(filePath, spec.requiredFor));
+}
+//# sourceMappingURL=contract-registry.js.map

package/dist/src/compass/contract-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-registry.js","sourceRoot":"","sources":["../../../src/compass/contract-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;EAYE;AAEF,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,SAAS,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAO/E,MAAM,cAAc,GAA+B;IACjD;QACE,OAAO,EAAE,iBAAiB;QAC1B,WAAW,EAAE;YACX,kBAAkB;YAClB,mBAAmB;YACnB,qBAAqB;YACrB,kBAAkB;YAClB,mBAAmB;YACnB,sBAAsB;YACtB,kBAAkB;YAClB,cAAc;YACd,eAAe;YACf,iBAAiB;SAClB;QACD,YAAY,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;KACzE;IACD;QACE,OAAO,EAAE,gBAAgB;QACzB,WAAW,EAAE;YACX,kBAAkB;YAClB,mBAAmB;YACnB,qBAAqB;YACrB,kBAAkB;YAClB,mBAAmB;YACnB,sBAAsB;YACtB,kBAAkB;YAClB,cAAc;YACd,eAAe;YACf,iBAAiB;SAClB;QACD,YAAY,EAAE,EAAE;KACjB;CACF,CAAC;AAEF,MAAM,UAAU,eAAe;IAC7B,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,aAAqB,EACrB,MAAoB;IAEpB,MAAM,IAAI,GAAmC,EAAE,CAAC;IAChD,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IAEvC,IAAI,MAAM,EAAE,UAAU,EAAE,CAAC;QACvB,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;YAC3D,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;YAC7D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC;gBAAE,SAAS;YAE3C,IAAI,WAAmB,CAAC;YACxB,IAAI,CAAC;gBACH,WAAW,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACvD,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YAED,IAAI,cAAuB,CAAC;YAC5B,IAAI,CAAC;gBACH,cAAc,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;YAC1C,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YAED,MAAM,MAAM,GAAG,yBAAyB,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;YACnE,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE,SAAS;YAE9B,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;YAC7B,MAAM,MAAM,GAAG,QAAQ,CAAC,eAAe,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC;YACnE,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAE7C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;oBACpC,MAAM,IAAI,KAAK,CACb,6CAA6C,KAAK,CAAC,OAAO,uBAAuB,QAAQ,CAAC,EAAE,qFAAqF,CAClL,CAAC;gBACJ,CAAC;gBACD,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAChC,IAAI,CAAC,IAAI,CAAC;oBACR,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,WAAW,EAAE,KAAK,CAAC,WAAW;oBAC9B,YAAY,EAAE,KAAK,CAAC,YAAY;oBAChC,MAAM,EAAE,QAAQ,CAAC,EAAE;iBACpB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE,cAAc;QACvB,IAAI;KACL,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,KAAe;IAChE,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC/D,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,QAAiC,EACjC,QAAgB;IAEhB,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;AACtF,CAAC"}

package/dist/src/compass/types.d.ts

@@ -0,0 +1,28 @@
+export interface CompassContractRequiredTag {
+    name: string;
+    minWords?: number;
+}
+export interface CompassContractBlockSpec {
+    blockId: string;
+    requiredFor: string[];
+    requiredTags?: CompassContractRequiredTag[];
+}
+export interface CompassContractExtensionPoint {
+    blocks: CompassContractBlockSpec[];
+}
+export interface CompassContractRegistryEntry extends CompassContractBlockSpec {
+    packId: string;
+}
+export interface CompassContractRegistry {
+    builtIn: CompassContractBlockSpec[];
+    pack: CompassContractRegistryEntry[];
+}
+export interface CompassContractValidationDiagnostic {
+    ruleId: string;
+    severity: string;
+    file: string;
+    message: string;
+    fix: string;
+    pack?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/compass/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/compass/types.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,0BAA0B,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,wBAAwB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,4BAA6B,SAAQ,wBAAwB;IAC5E,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,wBAAwB,EAAE,CAAC;IACpC,IAAI,EAAE,4BAA4B,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,mCAAmC;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/src/compass/types.js

@@ -0,0 +1,14 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Compass contract block spec types for plugin-extensible Compass validation (RFC-0943). Declarative data contracts only — no executable hooks.</purpose>
+<non-goals>
+  <item>Do not define validate() functions — block specs are declarative data, interpreted by compass.validate.</item>
+  <item>Do not import from os/ or kernel modules — this is a portable contract module.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0943: initial CompassContractBlockSpec and CompassContractExtensionPoint types.</item>
+</CHANGE_SUMMARY>
+*/
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/compass/types.js.map

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

package/dist/src/config/forge-config.d.ts

@@ -0,0 +1,242 @@
+import { z } from "zod";
+import { type StackProfile } from "../profiles/stack-profile.ts";
+export declare const forgeBindingsSchema: z.ZodObject<{
+    schema: z.ZodLiteral<"forge/bindings@1">;
+    commands: z.ZodObject<{
+        validateRfc: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        validateAdr: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        implementStamp: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        typecheck: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        test: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        scopedBuild: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        specValidate: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        sessionSave: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        validate: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        produce: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        verify: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        preview: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        lint: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>;
+    paths: z.ZodObject<{
+        invariantsFile: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        compassDocs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        reviewsDir: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        handoffsDir: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        sessionsDir: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>;
+    terminology: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    compass: z.ZodOptional<z.ZodObject<{
+        fileExtensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        testPatterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    knowledge: z.ZodOptional<z.ZodObject<{
+        budgets: z.ZodOptional<z.ZodObject<{
+            hot: z.ZodNumber;
+            warm: z.ZodNumber;
+        }, z.core.$strip>>;
+        retentionDays: z.ZodOptional<z.ZodNumber>;
+        staleDays: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    memory: z.ZodOptional<z.ZodObject<{
+        budget: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export interface ForgeBindings {
+    schema: "forge/bindings@1";
+    commands: {
+        validateRfc: string | null;
+        validateAdr: string | null;
+        implementStamp: string | null;
+        typecheck: string | null;
+        test: string | null;
+        scopedBuild: string | null;
+        specValidate: string | null;
+        sessionSave: string | null;
+        validate: string | null;
+        produce: string | null;
+        verify: string | null;
+        preview: string | null;
+        lint: string | null;
+    };
+    paths: {
+        invariantsFile: string | null;
+        compassDocs: string[];
+        reviewsDir: string | null;
+        handoffsDir: string | null;
+        sessionsDir: string | null;
+    };
+    terminology: Record<string, string>;
+    compass?: {
+        fileExtensions?: string[];
+        testPatterns?: string[];
+    };
+    knowledge?: {
+        budgets?: {
+            hot: number;
+            warm: number;
+        };
+        retentionDays?: number;
+        staleDays?: number;
+    };
+    memory?: {
+        budget: number;
+    };
+}
+export declare const forgeSkillPackSchema: z.ZodObject<{
+    prefix: z.ZodString;
+    dir: z.ZodString;
+}, z.core.$strip>;
+export interface ForgeSkillPack {
+    prefix: string;
+    dir: string;
+}
+export declare const forgeMigrationAdapterSchema: z.ZodObject<{
+    id: z.ZodString;
+    module: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export interface ForgeMigrationAdapter {
+    id: string;
+    module?: string;
+}
+export declare const forgeConfigSchema: z.ZodObject<{
+    schema: z.ZodLiteral<"forge/config@1">;
+    project: z.ZodObject<{
+        name: z.ZodString;
+        stack: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        packageManager: z.ZodDefault<z.ZodEnum<{
+            pnpm: "pnpm";
+            npm: "npm";
+            yarn: "yarn";
+            bun: "bun";
+            none: "none";
+        }>>;
+        domain: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    paths: z.ZodObject<{
+        rfcsDir: z.ZodDefault<z.ZodString>;
+        adrsDir: z.ZodDefault<z.ZodString>;
+        plansDir: z.ZodDefault<z.ZodString>;
+        auditsDir: z.ZodDefault<z.ZodString>;
+        specsDir: z.ZodDefault<z.ZodString>;
+        skillsDir: z.ZodDefault<z.ZodString>;
+        sessionsDir: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    bindings: z.ZodOptional<z.ZodObject<{
+        schema: z.ZodLiteral<"forge/bindings@1">;
+        commands: z.ZodObject<{
+            validateRfc: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            validateAdr: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            implementStamp: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            typecheck: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            test: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            scopedBuild: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            specValidate: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            sessionSave: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            validate: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            produce: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            verify: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            preview: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            lint: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>;
+        paths: z.ZodObject<{
+            invariantsFile: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            compassDocs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            reviewsDir: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            handoffsDir: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            sessionsDir: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>;
+        terminology: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        compass: z.ZodOptional<z.ZodObject<{
+            fileExtensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            testPatterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        knowledge: z.ZodOptional<z.ZodObject<{
+            budgets: z.ZodOptional<z.ZodObject<{
+                hot: z.ZodNumber;
+                warm: z.ZodNumber;
+            }, z.core.$strip>>;
+            retentionDays: z.ZodOptional<z.ZodNumber>;
+            staleDays: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        memory: z.ZodOptional<z.ZodObject<{
+            budget: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    skillPacks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        prefix: z.ZodString;
+        dir: z.ZodString;
+    }, z.core.$strip>>>;
+    migrationAdapters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        module: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    forge: z.ZodOptional<z.ZodObject<{
+        syncedVersion: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    profile: z.ZodOptional<z.ZodString>;
+    independentVersionPackages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export interface ForgeConfig {
+    schema: "forge/config@1";
+    project: {
+        name: string;
+        stack: string[];
+        packageManager: "pnpm" | "npm" | "yarn" | "bun" | "none";
+        /** RFC-0640: optional domain field — absent means software-domain fallback */
+        domain?: string;
+    };
+    paths: {
+        rfcsDir: string;
+        adrsDir: string;
+        plansDir: string;
+        auditsDir: string;
+        specsDir: string;
+        skillsDir: string;
+        sessionsDir: string;
+    };
+    /** Bindings contract (RFC-0393). Optional — absent means no bindings. */
+    bindings?: ForgeBindings;
+    /** Skill packs (RFC-0539). Optional — absent means no project-local packs. */
+    skillPacks?: ForgeSkillPack[];
+    /** Migration adapters (RFC-0546). Optional — absent means built-in adapters only. */
+    migrationAdapters?: ForgeMigrationAdapter[];
+    /** Forge sync metadata (RFC-0543). Optional — absent means never synced. */
+    forge?: {
+        syncedVersion: string | null;
+    };
+    /** RFC-0643: loaded stack profile — present when forge.yaml has a `profile` field */
+    profile?: StackProfile;
+    /** RFC-0704: packages with autonomous npm versions — ecosystem.commit skips platform bump when all staged files belong to these packages */
+    independentVersionPackages?: string[];
+}
+export interface ForgeCliBindingDefault {
+    key: string;
+    template: string;
+}
+export declare const FORGE_CLI_BINDING_DEFAULTS: ForgeCliBindingDefault[];
+export declare const PM_RUNNER_MAP: Record<string, string>;
+export declare function resolvePmRunner(pm: string): string;
+export declare const PM_INSTALL_MAP: Record<string, string>;
+export declare function resolvePmInstall(pm: string): string;
+export declare function applyCliBindingDefaults(pm: string): ForgeBindings["commands"];
+export type ForgePackageManager = ForgeConfig["project"]["packageManager"];
+export declare function resolvePackageManager(pm: string): ForgePackageManager;
+export declare function defaultForgeConfig(projectName: string, packageManager?: string): ForgeConfig;
+export declare function loadForgeConfig(workspaceRoot: string, forgeRootOverride?: string): ForgeConfig;
+export declare function resolveForgeRoot(workspaceRoot: string): string;
+/**
+ * Resolve a binding key (e.g. "commands.validateRfc") from the config.
+ * Returns the resolved string/array, or null if the binding is absent or explicitly null.
+ * Supports placeholder substitution: {id}, {workspace}, {file}.
+ */
+export declare function resolveBinding(config: ForgeConfig, key: string, placeholders?: Record<string, string>): string | string[] | null;
+/**
+ * Resolve a terminology key using a three-tier chain:
+ * 1. Per-project override in bindings.terminology
+ * 2. Caller-provided terminology map (typically from profile.terminology, RFC-0638)
+ * 3. Universal default from TERMINOLOGY_DEFAULTS (RFC-0638)
+ *
+ * If the key is not found in any tier, the key itself is returned.
+ */
+export declare function resolveTerminology(config: ForgeConfig, terminology: Record<string, string> | undefined, key: string): string;
+//# sourceMappingURL=forge-config.d.ts.map

package/dist/src/config/forge-config.d.ts.map

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