@warpgogol/forge 0.9.0 → 0.11.0

package/package.json

@@ -1,113 +1,121 @@
 {
   "name": "@warpgogol/forge",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",
   "description": "Framework for documenting and implementing ideas — RFC/ADR governance, skills, and project bootstrapping.",
-  "keywords": ["rfc", "adr", "governance", "skills", "ai-agent", "documentation", "framework"],
+  "keywords": [
+    "rfc",
+    "adr",
+    "governance",
+    "skills",
+    "ai-agent",
+    "documentation",
+    "framework"
+  ],
   "homepage": "https://warpgogol.com",
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
   "bin": {
     "forge": "./bin/cli.js"
   },
   "exports": {
     ".": {
-      "types": "./src/index.ts",
-      "default": "./src/index.ts"
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
     },
     "./types": {
-      "types": "./src/types.ts",
-      "default": "./src/types.ts"
+      "types": "./dist/src/types.d.ts",
+      "default": "./dist/src/types.js"
     },
     "./utils": {
-      "types": "./src/utils/index.ts",
-      "default": "./src/utils/index.ts"
+      "types": "./dist/src/utils/index.d.ts",
+      "default": "./dist/src/utils/index.js"
     },
     "./config": {
-      "types": "./src/config/forge-config.ts",
-      "default": "./src/config/forge-config.ts"
+      "types": "./dist/src/config/forge-config.d.ts",
+      "default": "./dist/src/config/forge-config.js"
     },
     "./os/core": {
-      "types": "./os/core/core.module.ts",
-      "default": "./os/core/core.module.ts"
+      "types": "./dist/os/core/core.module.d.ts",
+      "default": "./dist/os/core/core.module.js"
     },
     "./os/compass": {
-      "types": "./os/compass/index.ts",
-      "default": "./os/compass/index.ts"
+      "types": "./dist/os/compass/index.d.ts",
+      "default": "./dist/os/compass/index.js"
     },
     "./os/naming": {
-      "types": "./os/naming/index.ts",
-      "default": "./os/naming/index.ts"
+      "types": "./dist/os/naming/index.d.ts",
+      "default": "./dist/os/naming/index.js"
     },
     "./os/naming-module": {
-      "types": "./os/naming/naming.module.ts",
-      "default": "./os/naming/naming.module.ts"
+      "types": "./dist/os/naming/naming.module.d.ts",
+      "default": "./dist/os/naming/naming.module.js"
     },
     "./os/rfc": {
-      "types": "./os/rfc/index.ts",
-      "default": "./os/rfc/index.ts"
+      "types": "./dist/os/rfc/index.d.ts",
+      "default": "./dist/os/rfc/index.js"
     },
     "./os/rfc-module": {
-      "types": "./os/rfc/rfc.module.ts",
-      "default": "./os/rfc/rfc.module.ts"
+      "types": "./dist/os/rfc/rfc.module.d.ts",
+      "default": "./dist/os/rfc/rfc.module.js"
     },
     "./os/werkstatt": {
-      "types": "./os/werkstatt/index.ts",
-      "default": "./os/werkstatt/index.ts"
+      "types": "./dist/os/werkstatt/index.d.ts",
+      "default": "./dist/os/werkstatt/index.js"
     },
     "./os/workflow": {
-      "types": "./os/workflow/index.ts",
-      "default": "./os/workflow/index.ts"
+      "types": "./dist/os/workflow/index.d.ts",
+      "default": "./dist/os/workflow/index.js"
     },
     "./os/workflow-module": {
-      "types": "./os/workflow/workflow.module.ts",
-      "default": "./os/workflow/workflow.module.ts"
+      "types": "./dist/os/workflow/workflow.module.d.ts",
+      "default": "./dist/os/workflow/workflow.module.js"
     },
     "./os/spec-module": {
-      "types": "./os/spec/spec.module.ts",
-      "default": "./os/spec/spec.module.ts"
+      "types": "./dist/os/spec/spec.module.d.ts",
+      "default": "./dist/os/spec/spec.module.js"
     },
     "./os/adr": {
-      "types": "./os/adr/index.ts",
-      "default": "./os/adr/index.ts"
+      "types": "./dist/os/adr/index.d.ts",
+      "default": "./dist/os/adr/index.js"
     },
     "./os/adr-module": {
-      "types": "./os/adr/adr.module.ts",
-      "default": "./os/adr/adr.module.ts"
+      "types": "./dist/os/adr/adr.module.d.ts",
+      "default": "./dist/os/adr/adr.module.js"
     },
     "./os/plan": {
-      "types": "./os/plan/index.ts",
-      "default": "./os/plan/index.ts"
+      "types": "./dist/os/plan/index.d.ts",
+      "default": "./dist/os/plan/index.js"
     },
     "./os/plan-module": {
-      "types": "./os/plan/plan.module.ts",
-      "default": "./os/plan/plan.module.ts"
+      "types": "./dist/os/plan/plan.module.d.ts",
+      "default": "./dist/os/plan/plan.module.js"
     },
     "./os/audit": {
-      "types": "./os/audit/index.ts",
-      "default": "./os/audit/index.ts"
+      "types": "./dist/os/audit/index.d.ts",
+      "default": "./dist/os/audit/index.js"
     },
     "./os/audit-module": {
-      "types": "./os/audit/audit.module.ts",
-      "default": "./os/audit/audit.module.ts"
+      "types": "./dist/os/audit/audit.module.d.ts",
+      "default": "./dist/os/audit/audit.module.js"
     },
     "./os/session": {
-      "types": "./os/session/index.ts",
-      "default": "./os/session/index.ts"
+      "types": "./dist/os/session/index.d.ts",
+      "default": "./dist/os/session/index.js"
     },
     "./os/session-module": {
-      "types": "./os/session/session.module.ts",
-      "default": "./os/session/session.module.ts"
+      "types": "./dist/os/session/session.module.d.ts",
+      "default": "./dist/os/session/session.module.js"
     },
     "./os/mission": {
-      "types": "./os/mission/index.ts",
-      "default": "./os/mission/index.ts"
+      "types": "./dist/os/mission/index.d.ts",
+      "default": "./dist/os/mission/index.js"
     },
     "./os/mission-module": {
-      "types": "./os/mission/mission.module.ts",
-      "default": "./os/mission/mission.module.ts"
+      "types": "./dist/os/mission/mission.module.d.ts",
+      "default": "./dist/os/mission/mission.module.js"
     }
   },
   "files": [
@@ -121,14 +129,6 @@
     "README.md",
     "LICENSE"
   ],
-  "scripts": {
-    "build": "pnpm exec tsc -p tsconfig.json",
-    "build:check": "pnpm exec tsc -p tsconfig.json --noEmit",
-    "clean": "rm -rf dist",
-    "prepublishOnly": "pnpm run clean && pnpm run build && node scripts/publish-check.mjs",
-    "test": "vitest run --passWithNoTests",
-    "test:watch": "vitest"
-  },
   "dependencies": {
     "yaml": "^2.9.0",
     "zod": "^4.4.3"
@@ -143,106 +143,13 @@
     "node": ">=18.0.0"
   },
   "publishConfig": {
-    "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"
-      }
-    }
+    "access": "public"
+  },
+  "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"
   }
-}
+}

package/profiles/editframe-html.yaml

@@ -14,6 +14,9 @@ terminology:
   output: render
   verify: render-verify
   operator: director
+devServer:
+  command: editframe preview
+  port: 4321
 artifacts:
   - id: composition
     extensions:
@@ -27,9 +30,8 @@ artifacts:
     determinism:
       hashable: true
       inputs:
-        - composition files
-        - assets
-        - editframe version
+        - compositions/**/*.html
+        - assets/**
 workspaceTypes:
   - id: composition
     detect:
@@ -44,12 +46,24 @@ invariants:
   - id: VIDEO-01
     rule: Composition filenames must use kebab-case (lowercase letters, digits, hyphens only)
     severity: error
+    check:
+      kind: filename-pattern
+      glob: "compositions/**/*.{html,tsx}"
+      pattern: "^[a-z0-9-]+\\.(html|tsx)$"
   - id: VIDEO-02
     rule: Scene durations must use contain mode by default to avoid unexpected cropping
     severity: warning
+    check:
+      kind: file-contains
+      glob: "compositions/**/*.html"
+      pattern: contain
   - id: VIDEO-03
     rule: All speech audio elements must have corresponding ef-captions elements for accessibility
     severity: error
+    check:
+      kind: file-contains
+      glob: "compositions/**/*.html"
+      pattern: ef-captions
 workspace:
   dirs:
     - compositions

package/skills/fo/fo-add-tests/SKILL.md

@@ -83,8 +83,10 @@ Mock at **system boundaries** only — external APIs, databases, time, randomnes
 
 For the target package:
 
+> Commands below assume RTK is installed. To check, run `rtk --version` (this is the detection command — it is not prefixed with `rtk` because it IS an `rtk` command). If `rtk --version` fails, RTK is not installed — run all commands without the `rtk` prefix.
+
 ```sh
-pnpm --filter <package-name> test
+rtk pnpm --filter <package-name> test
 ```
 
 If the tests fail (red):

package/skills/fo/fo-doc-audit/SKILL.md

@@ -124,6 +124,8 @@ If yes, update the **template** files in `packages/os/site-kernel-onboarding/src
 
 If yes, **do not edit the generated file directly**. Update the source registry or generator, then run the regeneration command:
 
+> Commands below assume RTK is installed. To check, run `rtk --version` (this is the detection command — it is not prefixed with `rtk` because it IS an `rtk` command). If `rtk --version` fails, RTK is not installed — run all commands without the `rtk` prefix.
+
 ```sh
 ref(forge.yaml bindings.commands.produce) --workspace=ecosystem.manifest.generate
 ref(forge.yaml bindings.commands.produce) --workspace=command.manifest.generate

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

@@ -95,7 +95,9 @@ Otherwise, determine which workspaces were touched by the fixes in step 2 and ru
 
 - **For each touched `apps/*` workspace:**
 
-  ```sh
+  > Commands below assume RTK is installed. To check, run `rtk --version` (this is the detection command — it is not prefixed with `rtk` because it IS an `rtk` command). If `rtk --version` fails, RTK is not installed — run all commands without the `rtk` prefix.
+
+```sh
   pnpm --filter <app-name> exec astro check
   ```
 
@@ -121,8 +123,8 @@ All scoped checks must pass. If any fails:
 Stage and commit the changes with a descriptive message.
 
 ```text
-git add ...
-git commit -m "fix(scope): ..."
+rtk git add ...
+rtk git commit -m "fix(scope): ..."
 ```
 
 Do not commit secrets, API keys, or unrelated changes.

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

@@ -53,6 +53,8 @@ Read the full RFC file at `docs/rfcs/rfc-XXXX-*.md` for the first RFC to process
 
 Run the mechanical floor first — it catches format, referential, and structural violations that don't need semantic judgment:
 
+> Commands below assume RTK is installed. To check, run `rtk --version` (this is the detection command — it is not prefixed with `rtk` because it IS an `rtk` command). If `rtk --version` fails, RTK is not installed — run all commands without the `rtk` prefix.
+
 ```sh
 ref(forge.yaml bindings.commands.validateRfc) --json
 ```

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

@@ -76,6 +76,8 @@ Address every concern the grilling raises by adjusting the metadata, scope, or c
 
 Run:
 
+> Commands below assume RTK is installed. To check, run `rtk --version` (this is the detection command — it is not prefixed with `rtk` because it IS an `rtk` command). If `rtk --version` fails, RTK is not installed — run all commands without the `rtk` prefix.
+
 ```sh
 ref(forge.yaml bindings.commands.validateAdr) --create --title="<title>" --scope=<scope> --related=<related-ids>
 ```

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

@@ -31,6 +31,8 @@ Create a complete, `rfc.validate`-ready RFC draft in `docs/rfcs/` using the full
 
 Confirm that the proposed change is not already covered by an accepted/implemented RFC. Before drafting, run:
 
+> Commands below assume RTK is installed. To check, run `rtk --version` (this is the detection command — it is not prefixed with `rtk` because it IS an `rtk` command). If `rtk --version` fails, RTK is not installed — run all commands without the `rtk` prefix.
+
 ```sh
 ref(forge.yaml bindings.commands.validateRfc) --status accepted --json
 ```

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

@@ -67,7 +67,9 @@ Read the RFC's `status` frontmatter:
 - **`draft`** — proceed with enhancement.
 - **`reviewing`** — transition to `draft` before enhancement. Set `status: draft`, update `updatedAt` to today's date, commit:
 
-  ```txt
+  > Commands below assume RTK is installed. To check, run `rtk --version` (this is the detection command — it is not prefixed with `rtk` because it IS an `rtk` command). If `rtk --version` fails, RTK is not installed — run all commands without the `rtk` prefix.
+
+```txt
   rfc: revert RFC-XXXX to draft for enhancement
 
   Transition RFC-XXXX from reviewing to draft before enhance.

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

@@ -73,7 +73,9 @@ Execute the plan's step sequence in order. For each step:
 2. **Validate** — run the step's validation command (lightweight only: `rfc.validate`, type checks, unit tests on touched files). Do **not** run heavy checks (`root build`, `build:check`, `astro:check`) during implementation — they run only after all steps are complete.
 3. **Commit** after each step or phase that produces a coherent, complete unit of work:
 
-   ```txt
+   > Commands below assume RTK is installed. To check, run `rtk --version` (this is the detection command — it is not prefixed with `rtk` because it IS an `rtk` command). If `rtk --version` fails, RTK is not installed — run all commands without the `rtk` prefix.
+
+```txt
    implement: RFC-XXXX step N — <step title>
 
    <one-line description of what was done in this step>.

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

@@ -64,7 +64,9 @@ If the RFC is `draft` or `reviewing` and has `enhancedAt` — the user's instruc
 3. Set `updatedAt` to today's date.
 4. Commit:
 
-   ```txt
+   > Commands below assume RTK is installed. To check, run `rtk --version` (this is the detection command — it is not prefixed with `rtk` because it IS an `rtk` command). If `rtk --version` fails, RTK is not installed — run all commands without the `rtk` prefix.
+
+```txt
    rfc: accept RFC-XXXX <short title>
 
    Transition RFC-XXXX to accepted status for planning.

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

@@ -36,6 +36,8 @@ Check the operator's input for:
 
 **Always** make a single call to `rfc.list --json` (no `--status` flag) and a single call to `adr.list --json`. Filter by status in memory from the returned `entries` array. Never make per-status calls.
 
+> Commands below assume RTK is installed. To check, run `rtk --version` (this is the detection command — it is not prefixed with `rtk` because it IS an `rtk` command). If `rtk --version` fails, RTK is not installed — run all commands without the `rtk` prefix.
+
 ```sh
 ref(forge.yaml bindings.commands.validateRfc) --list --json
 ref(forge.yaml bindings.commands.validateAdr) --list --json

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

@@ -51,14 +51,16 @@ Run the mechanical floor first — it catches type errors, lint violations, and
 
 For a single affected package:
 
+> Commands below assume RTK is installed. To check, run `rtk --version` (this is the detection command — it is not prefixed with `rtk` because it IS an `rtk` command). If `rtk --version` fails, RTK is not installed — run all commands without the `rtk` prefix.
+
 ```sh
-pnpm --filter <package-name> build:check
+rtk pnpm --filter <package-name> build:check
 ```
 
 For an affected app:
 
 ```sh
-pnpm --filter <app-name> exec astro check
+rtk pnpm --filter <app-name> exec astro check
 ```
 
 For cross-workspace changes, run the affected workspaces' checks individually rather than a full root build.