@warpgogol/forge 0.26.0 → 0.27.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warpgogol/forge",
-  "version": "0.26.0",
+  "version": "0.27.0",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",
@@ -15,115 +15,115 @@
     "framework"
   ],
   "homepage": "https://warpgogol.com",
-  "main": "./dist/src/index.js",
-  "types": "./dist/src/index.d.ts",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
   "bin": {
     "forge": "./bin/cli.js"
   },
   "exports": {
     ".": {
-      "types": "./dist/src/index.d.ts",
-      "default": "./dist/src/index.js"
+      "types": "./src/index.ts",
+      "default": "./src/index.ts"
     },
     "./types": {
-      "types": "./dist/src/types.d.ts",
-      "default": "./dist/src/types.js"
+      "types": "./src/types.ts",
+      "default": "./src/types.ts"
     },
     "./utils": {
-      "types": "./dist/src/utils/index.d.ts",
-      "default": "./dist/src/utils/index.js"
+      "types": "./src/utils/index.ts",
+      "default": "./src/utils/index.ts"
     },
     "./config": {
-      "types": "./dist/src/config/forge-config.d.ts",
-      "default": "./dist/src/config/forge-config.js"
+      "types": "./src/config/forge-config.ts",
+      "default": "./src/config/forge-config.ts"
     },
     "./os/core": {
-      "types": "./dist/os/core/core.module.d.ts",
-      "default": "./dist/os/core/core.module.js"
+      "types": "./os/core/core.module.ts",
+      "default": "./os/core/core.module.ts"
     },
     "./os/compass": {
-      "types": "./dist/os/compass/index.d.ts",
-      "default": "./dist/os/compass/index.js"
+      "types": "./os/compass/index.ts",
+      "default": "./os/compass/index.ts"
     },
     "./os/naming": {
-      "types": "./dist/os/naming/index.d.ts",
-      "default": "./dist/os/naming/index.js"
+      "types": "./os/naming/index.ts",
+      "default": "./os/naming/index.ts"
     },
     "./os/naming-module": {
-      "types": "./dist/os/naming/naming.module.d.ts",
-      "default": "./dist/os/naming/naming.module.js"
+      "types": "./os/naming/naming.module.ts",
+      "default": "./os/naming/naming.module.ts"
     },
     "./os/rfc": {
-      "types": "./dist/os/rfc/index.d.ts",
-      "default": "./dist/os/rfc/index.js"
+      "types": "./os/rfc/index.ts",
+      "default": "./os/rfc/index.ts"
     },
     "./os/rfc-module": {
-      "types": "./dist/os/rfc/rfc.module.d.ts",
-      "default": "./dist/os/rfc/rfc.module.js"
+      "types": "./os/rfc/rfc.module.ts",
+      "default": "./os/rfc/rfc.module.ts"
     },
     "./os/werkstatt": {
-      "types": "./dist/os/werkstatt/index.d.ts",
-      "default": "./dist/os/werkstatt/index.js"
+      "types": "./os/werkstatt/index.ts",
+      "default": "./os/werkstatt/index.ts"
     },
     "./os/workflow": {
-      "types": "./dist/os/workflow/index.d.ts",
-      "default": "./dist/os/workflow/index.js"
+      "types": "./os/workflow/index.ts",
+      "default": "./os/workflow/index.ts"
     },
     "./os/workflow-module": {
-      "types": "./dist/os/workflow/workflow.module.d.ts",
-      "default": "./dist/os/workflow/workflow.module.js"
+      "types": "./os/workflow/workflow.module.ts",
+      "default": "./os/workflow/workflow.module.ts"
     },
     "./os/spec-module": {
-      "types": "./dist/os/spec/spec.module.d.ts",
-      "default": "./dist/os/spec/spec.module.js"
+      "types": "./os/spec/spec.module.ts",
+      "default": "./os/spec/spec.module.ts"
     },
     "./os/adr": {
-      "types": "./dist/os/adr/index.d.ts",
-      "default": "./dist/os/adr/index.js"
+      "types": "./os/adr/index.ts",
+      "default": "./os/adr/index.ts"
     },
     "./os/adr-module": {
-      "types": "./dist/os/adr/adr.module.d.ts",
-      "default": "./dist/os/adr/adr.module.js"
+      "types": "./os/adr/adr.module.ts",
+      "default": "./os/adr/adr.module.ts"
     },
     "./os/plan": {
-      "types": "./dist/os/plan/index.d.ts",
-      "default": "./dist/os/plan/index.js"
+      "types": "./os/plan/index.ts",
+      "default": "./os/plan/index.ts"
     },
     "./os/plan-module": {
-      "types": "./dist/os/plan/plan.module.d.ts",
-      "default": "./dist/os/plan/plan.module.js"
+      "types": "./os/plan/plan.module.ts",
+      "default": "./os/plan/plan.module.ts"
     },
     "./os/audit": {
-      "types": "./dist/os/audit/index.d.ts",
-      "default": "./dist/os/audit/index.js"
+      "types": "./os/audit/index.ts",
+      "default": "./os/audit/index.ts"
     },
     "./os/audit-module": {
-      "types": "./dist/os/audit/audit.module.d.ts",
-      "default": "./dist/os/audit/audit.module.js"
+      "types": "./os/audit/audit.module.ts",
+      "default": "./os/audit/audit.module.ts"
     },
     "./os/session": {
-      "types": "./dist/os/session/index.d.ts",
-      "default": "./dist/os/session/index.js"
+      "types": "./os/session/index.ts",
+      "default": "./os/session/index.ts"
     },
     "./os/session-module": {
-      "types": "./dist/os/session/session.module.d.ts",
-      "default": "./dist/os/session/session.module.js"
+      "types": "./os/session/session.module.ts",
+      "default": "./os/session/session.module.ts"
     },
     "./os/mission": {
-      "types": "./dist/os/mission/index.d.ts",
-      "default": "./dist/os/mission/index.js"
+      "types": "./os/mission/index.ts",
+      "default": "./os/mission/index.ts"
     },
     "./os/mission-module": {
-      "types": "./dist/os/mission/mission.module.d.ts",
-      "default": "./dist/os/mission/mission.module.js"
+      "types": "./os/mission/mission.module.ts",
+      "default": "./os/mission/mission.module.ts"
     },
     "./os/exploration": {
-      "types": "./dist/os/exploration/index.d.ts",
-      "default": "./dist/os/exploration/index.js"
+      "types": "./os/exploration/index.ts",
+      "default": "./os/exploration/index.ts"
     },
     "./os/exploration-module": {
-      "types": "./dist/os/exploration/exploration.module.d.ts",
-      "default": "./dist/os/exploration/exploration.module.js"
+      "types": "./os/exploration/exploration.module.ts",
+      "default": "./os/exploration/exploration.module.ts"
     }
   },
   "files": [
@@ -137,6 +137,14 @@
     "README.md",
     "LICENSE"
   ],
+  "scripts": {
+    "build": "pnpm exec tsc -p tsconfig.json",
+    "build:check": "pnpm exec tsc -p tsconfig.json --noEmit",
+    "lint": "pnpm exec eslint src --ext .ts",
+    "typecheck": "pnpm exec tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  },
   "dependencies": {
     "@aws-sdk/client-s3": "^3.700.0",
     "trash": "^10.1.1",
@@ -153,13 +161,115 @@
     "node": ">=20.0.0"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "main": "./dist/src/index.js",
+    "types": "./dist/src/index.d.ts",
+    "exports": {
+      ".": {
+        "types": "./dist/src/index.d.ts",
+        "default": "./dist/src/index.js"
+      },
+      "./types": {
+        "types": "./dist/src/types.d.ts",
+        "default": "./dist/src/types.js"
+      },
+      "./utils": {
+        "types": "./dist/src/utils/index.d.ts",
+        "default": "./dist/src/utils/index.js"
+      },
+      "./config": {
+        "types": "./dist/src/config/forge-config.d.ts",
+        "default": "./dist/src/config/forge-config.js"
+      },
+      "./os/core": {
+        "types": "./dist/os/core/core.module.d.ts",
+        "default": "./dist/os/core/core.module.js"
+      },
+      "./os/compass": {
+        "types": "./dist/os/compass/index.d.ts",
+        "default": "./dist/os/compass/index.js"
+      },
+      "./os/naming": {
+        "types": "./dist/os/naming/index.d.ts",
+        "default": "./dist/os/naming/index.js"
+      },
+      "./os/naming-module": {
+        "types": "./dist/os/naming/naming.module.d.ts",
+        "default": "./dist/os/naming/naming.module.js"
+      },
+      "./os/rfc": {
+        "types": "./dist/os/rfc/index.d.ts",
+        "default": "./dist/os/rfc/index.js"
+      },
+      "./os/rfc-module": {
+        "types": "./dist/os/rfc/rfc.module.d.ts",
+        "default": "./dist/os/rfc/rfc.module.js"
+      },
+      "./os/werkstatt": {
+        "types": "./dist/os/werkstatt/index.d.ts",
+        "default": "./dist/os/werkstatt/index.js"
+      },
+      "./os/workflow": {
+        "types": "./dist/os/workflow/index.d.ts",
+        "default": "./dist/os/workflow/index.js"
+      },
+      "./os/workflow-module": {
+        "types": "./dist/os/workflow/workflow.module.d.ts",
+        "default": "./dist/os/workflow/workflow.module.js"
+      },
+      "./os/spec-module": {
+        "types": "./dist/os/spec/spec.module.d.ts",
+        "default": "./dist/os/spec/spec.module.js"
+      },
+      "./os/adr": {
+        "types": "./dist/os/adr/index.d.ts",
+        "default": "./dist/os/adr/index.js"
+      },
+      "./os/adr-module": {
+        "types": "./dist/os/adr/adr.module.d.ts",
+        "default": "./dist/os/adr/adr.module.js"
+      },
+      "./os/plan": {
+        "types": "./dist/os/plan/index.d.ts",
+        "default": "./dist/os/plan/index.js"
+      },
+      "./os/plan-module": {
+        "types": "./dist/os/plan/plan.module.d.ts",
+        "default": "./dist/os/plan/plan.module.js"
+      },
+      "./os/audit": {
+        "types": "./dist/os/audit/index.d.ts",
+        "default": "./dist/os/audit/index.js"
+      },
+      "./os/audit-module": {
+        "types": "./dist/os/audit/audit.module.d.ts",
+        "default": "./dist/os/audit/audit.module.js"
+      },
+      "./os/session": {
+        "types": "./dist/os/session/index.d.ts",
+        "default": "./dist/os/session/index.js"
+      },
+      "./os/session-module": {
+        "types": "./dist/os/session/session.module.d.ts",
+        "default": "./dist/os/session/session.module.js"
+      },
+      "./os/mission": {
+        "types": "./dist/os/mission/index.d.ts",
+        "default": "./dist/os/mission/index.js"
+      },
+      "./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"
+      }
+    }
   },
-  "scripts": {
-    "build": "pnpm exec tsc -p tsconfig.json",
-    "build:check": "pnpm exec tsc -p tsconfig.json --noEmit",
-    "clean": "rm -rf dist",
-    "test": "vitest run --passWithNoTests",
-    "test:watch": "vitest"
-  }
-}
+  "packageManager": "pnpm@11.10.0"
+}

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

@@ -99,7 +99,7 @@ Every `run_command` call MUST use a 6-minute (360 000 ms) execution budget. This
 
 - The `run_command` tool has no built-in timeout parameter. `WaitMsBeforeAsync` is the only mechanism to regain control after a fixed duration.
 - Abandoning a still-running process is acceptable — the process may complete in the background, but the agent is unblocked and can retry or try an alternative.
-- This covers all command classes: `pnpm exec site-kernel run ...`, `pnpm --filter <pkg> run build:check`, `astro check`, `git`, `pnpm install`, etc.
+- This covers all command classes: `pnpm exec werkstatt run ...`, `pnpm --filter <pkg> run build:check`, `astro check`, `git`, `pnpm install`, etc.
 - Site-kernel commands already have internal `timeoutMs`, but the agent-side 6-min budget is a safety net for ALL commands, not just site-kernel.
 
 ## Binding resolution and degradation
@@ -140,8 +140,8 @@ Skills reference bindings by key, never by value. To resolve a binding:
 
 A skill needs to run `rfc.validate` for `RFC-XXXX`:
 
-1. Read `forge.yaml` → `bindings.commands.validateRfc` = `"pnpm exec site-kernel run rfc.validate {id} --json"`
-2. Substitute `{id}` → `"pnpm exec site-kernel run rfc.validate RFC-XXXX --json"`
+1. Read `forge.yaml` → `bindings.commands.validateRfc` = `"pnpm exec werkstatt run rfc.validate {id} --json"`
+2. Substitute `{id}` → `"pnpm exec werkstatt run rfc.validate RFC-XXXX --json"`
 3. Run the resolved command.
 
 If `bindings.commands.validateRfc` were `null`, the skill would skip the step and report: `Degraded: commands.validateRfc — not configured in forge.yaml`.

package/skills/fo/fo-compass-annotate/reference/comment-styles.md

@@ -4,18 +4,18 @@ Compass headers are embedded in source file comments. The comment syntax varies
 
 ## Mapping
 
-| Extension | Comment syntax | Example |
-| --- | --- | --- |
-| `.ts` | `/* ... */` block comment | `/* <MODULE_CONTRACT> ... </MODULE_CONTRACT> */` |
-| `.tsx` | `/* ... */` block comment | `/* <MODULE_CONTRACT> ... </MODULE_CONTRACT> */` |
-| `.astro` | `<!-- ... -->` HTML comment | `<!-- <MODULE_CONTRACT> ... </MODULE_CONTRACT> -->` |
-| `.js` | `/* ... */` block comment | `/* <MODULE_CONTRACT> ... </MODULE_CONTRACT> */` |
-| `.mjs` | `/* ... */` block comment | `/* <MODULE_CONTRACT> ... </MODULE_CONTRACT> */` |
-| `.css` | `/* ... */` block comment | `/* <MODULE_CONTRACT> ... </MODULE_CONTRACT> */` |
-| `.yaml` | `# ` line comment | `# <MODULE_CONTRACT>` (each line prefixed with `# `) |
-| `.yml` | `# ` line comment | `# <MODULE_CONTRACT>` (each line prefixed with `# `) |
-| `.json` | Not supported | JSON files cannot carry comments; skip Compass headers |
-| `.md` | `<!-- ... -->` HTML comment | `<!-- <MODULE_CONTRACT> ... </MODULE_CONTRACT> -->` |
+| Extension | Comment syntax              | Example                                                |
+| --------- | --------------------------- | ------------------------------------------------------ |
+| `.ts`     | `/* ... */` block comment   | `/* <MODULE_CONTRACT> ... </MODULE_CONTRACT> */`       |
+| `.tsx`    | `/* ... */` block comment   | `/* <MODULE_CONTRACT> ... </MODULE_CONTRACT> */`       |
+| `.astro`  | `<!-- ... -->` HTML comment | `<!-- <MODULE_CONTRACT> ... </MODULE_CONTRACT> -->`    |
+| `.js`     | `/* ... */` block comment   | `/* <MODULE_CONTRACT> ... </MODULE_CONTRACT> */`       |
+| `.mjs`    | `/* ... */` block comment   | `/* <MODULE_CONTRACT> ... </MODULE_CONTRACT> */`       |
+| `.css`    | `/* ... */` block comment   | `/* <MODULE_CONTRACT> ... </MODULE_CONTRACT> */`       |
+| `.yaml`   | `# ` line comment           | `# <MODULE_CONTRACT>` (each line prefixed with `# `)   |
+| `.yml`    | `# ` line comment           | `# <MODULE_CONTRACT>` (each line prefixed with `# `)   |
+| `.json`   | Not supported               | JSON files cannot carry comments; skip Compass headers |
+| `.md`     | `<!-- ... -->` HTML comment | `<!-- <MODULE_CONTRACT> ... </MODULE_CONTRACT> -->`    |
 
 ## Rules
 

package/skills/fo/fo-compass-annotate/reference/risk-patterns.md

@@ -4,16 +4,16 @@ These patterns are scanned deterministically (no LLM) to flag files that handle
 
 ## Patterns
 
-| Pattern | Regex | Risk level | Description |
-| --- | --- | --- | --- |
-| `sign` | `\b(sign|signing|signature)\b` | high | Cryptographic signing operations |
-| `crypto` | `\b(crypto|encrypt|decrypt|cipher|aes|rsa|hmac)\b` | high | Cryptographic operations |
-| `vault` | `\b(vault|secret|password|apiKey|api_key|token)\b` | high | Secret/credential handling |
-| `migrate` | `\b(migrate|migration|migrator)\b` | medium | Data migration logic |
-| `publish` | `\b(publish|deploy|release)\b` | medium | Publishing/deployment operations |
-| `delete` | `\b(delete|remove|destroy|purge)\b` | medium | Destructive operations |
-| `network` | `\b(fetch|http|request|axios|got)\b` | low | Network requests |
-| `fs-write` | `\b(writeFile|mkdir|rm |unlink|rename)\b` | low | Filesystem write operations |
+| Pattern    | Regex         | Risk level | Description   |
+| ---------- | ------------- | ---------- | ------------- |
+| `sign`     | `\b(sign      | signing    | signature)\b` | high      | Cryptographic signing operations |
+| `crypto`   | `\b(crypto    | encrypt    | decrypt       | cipher    | aes                              | rsa                    | hmac)\b`                    | high                       | Cryptographic operations |
+| `vault`    | `\b(vault     | secret     | password      | apiKey    | api_key                          | token)\b`              | high                        | Secret/credential handling |
+| `migrate`  | `\b(migrate   | migration  | migrator)\b`  | medium    | Data migration logic             |
+| `publish`  | `\b(publish   | deploy     | release)\b`   | medium    | Publishing/deployment operations |
+| `delete`   | `\b(delete    | remove     | destroy       | purge)\b` | medium                           | Destructive operations |
+| `network`  | `\b(fetch     | http       | request       | axios     | got)\b`                          | low                    | Network requests            |
+| `fs-write` | `\b(writeFile | mkdir      | rm            | unlink    | rename)\b`                       | low                    | Filesystem write operations |
 
 ## Rules
 

package/skills/fo/fo-idea/SKILL.md

@@ -223,6 +223,8 @@ Process documents **sequentially in dependency order** — foundational document
 2. When the creation skill collects metadata, include the cross-references:
    - **`related`** — list all other documents in the series by their assigned id (once created) or by title (if not yet created).
    - **`amends`** — if a document in the series amends an existing accepted RFC, set the `amends` field.
+   - **`dependsOn`** — for each document, based on the decomposition plan's dependency edges, write `dependsOn: [RFC-XXXX]` listing the RFC IDs that must be `implemented` before this RFC can be stamped. Direct dependencies only — not transitive.
+   - **`batch`** — write a shared `batch: <kebab-case-slug>` for all documents in the series. The slug should be descriptive of the overall task (e.g. "pbp-locale-fixes", "engine-consolidation"). Must match `/^[a-z0-9]+(-[a-z0-9]+)*$/`.
 3. The creation skill will grill, create, fill, validate, and report — let it run fully.
 4. After each document is created, record its assigned id for use in subsequent documents' `related` fields.
 5. Do not pause between documents in the series — continue to the next immediately.

package/skills/fo/fo-idea-implement/SKILL.md

@@ -503,6 +503,10 @@ If multiple documents were processed, present a single batch summary at the very
 
 Do not output per-document summaries or "Moving to XXXX next" messages during the loop; they belong here, at the very end.
 
+## Session affinity (advisory)
+
+When an RFC was planned in this session, prefer implementing it in this session too. The session context contains edge cases and mental models not fully captured in the plan text. If starting a new session, re-read the plan file and the RFC body before implementing. This is a recommendation, not a machine-enforced constraint — sessions have no forge-internal identity.
+
 ## Constraints
 
 - **Commit only your own files.** Stage only the files this skill produces or modifies — document files, code files touched by implementation, documentation files. Do not stage unrelated changes. Another agent may be working in a different session; `git add -A` or `git add .` is forbidden.

package/skills/fo/fo-idea-plan/SKILL.md

@@ -230,6 +230,10 @@ If multiple RFCs were processed, present a single batch summary in `aiLanguage`.
 
 Do not output per-RFC summaries or "Moving to RFC-XXXX next" messages during the loop; they belong here, at the very end.
 
+## Session affinity (advisory)
+
+When an RFC was planned in this session, prefer implementing it in this session too. The session context contains edge cases and mental models not fully captured in the plan text. If starting a new session, re-read the plan file and the RFC body before implementing. This is a recommendation, not a machine-enforced constraint — sessions have no forge-internal identity.
+
 ## Constraints
 
 - **Commit only your own files.** Stage only the files this skill produces or modifies — the plan file and the RFC file (for status transitions). Do not stage unrelated changes. Another agent may be working in a different session; `git add -A` or `git add .` is forbidden.

package/skills/fo/fo-memory-sync/learned-principles.md

@@ -1,6 +1,7 @@
 <!-- L2: Concrete principles distilled from past runs, with confirmations counter.
      At confirmations >= 3, the skill auto-applies the principle without asking.
      Rejecting a recommended answer resets confirmations to 0. -->
+
 # Learned Principles
 
 <!-- Format: - principle: <text> | confirmations: N | project: <path-or-remote-or-all> -->

package/skills/fo/fo-memory-sync/qa-log.md

@@ -1,5 +1,6 @@
 <!-- L0: Append-only Q&A log. Each entry records a question asked and the operator's answer.
      Format: [YYYY-MM-DD] project:<path-or-remote> Q: <question> A: <answer> -->
+
 # Q&A Log
 
 <!-- Entries are appended by the skill during runs. Do not hand-edit. -->

package/skills/fo/fo-session-save/qa-log.md

@@ -8,4 +8,4 @@ Each entry: date, question, answer, context.
 
 ---
 
-*(no questions asked yet — initial creation)*
+_(no questions asked yet — initial creation)_

package/skills/meta/port-to-forge/SKILL.md

@@ -28,7 +28,7 @@ Ask the operator what pattern (skill, command, or workflow) they want to port in
 Use the `grilling` skill to stress-test:
 
 - Is the pattern truly project-agnostic? Does it reference Forge-specific concepts (cosmic names, sections, biomes)?
-- Does it depend on project-specific packages (`@warpgogol/site-kernel`, `@warpgogol/ui`)?
+- Does it depend on project-specific packages (`@warpgogol/werkstatt`, `@warpgogol/werkstatt-site`)?
 - What are the minimal dependencies needed (ontology, fingerprint, share)?
 - Should it be a skill, a command, or both?
 
@@ -44,8 +44,8 @@ Run `port.scaffold --name <name> --type <skill|command> --category <category>` t
 
 Port the implementation, ensuring:
 
-- No imports from `@warpgogol/site-kernel` or other project-specific packages.
-- Use `@warpgogol/ontology` for schemas, `@warpgogol/fingerprint` for hashing, `@warpgogol/share` for fs helpers.
+- No imports from `@warpgogol/werkstatt` or other project-specific packages.
+- Use `@warpgogol/werkstatt-site/ontology` for schemas, `@warpgogol/werkstatt/fingerprint` for hashing, `@warpgogol/werkstatt-site/share` for fs helpers.
 - Add Compass scaffolding (MODULE_CONTRACT, CHANGE_SUMMARY) to new TypeScript files.
 
 ### 6. Validate