@warpgogol/forge 0.4.0 → 0.5.0

package/profiles/editframe-html.yaml

@@ -0,0 +1,283 @@
+schema: forge/stack-profile@1
+id: editframe-html
+displayName: Editframe HTML Video
+detect:
+  anyOf:
+    - editframe.config.*
+domain: video
+register: creative
+terminology:
+  artifact: composition
+  artifactPlural: compositions
+  module: scene
+  source: composition file
+  output: render
+  verify: render-verify
+  operator: director
+artifacts:
+  - id: composition
+    extensions:
+      - .html
+      - .tsx
+    produce:
+      command: editframe render
+      output: dist/{composition}.mp4
+    validate:
+      command: editframe check
+    determinism:
+      hashable: true
+      inputs:
+        - composition files
+        - assets
+        - editframe version
+workspaceTypes:
+  - id: composition
+    detect:
+      glob: "*.html"
+      contains: ef-timegroup
+      packageJsonDep: "@editframe/cli"
+    skills:
+      - ef-composition-review
+      - ef-render-verify
+    agentsMdTemplate: editframe-html-templates/composition-agents.md
+invariants:
+  - id: VIDEO-01
+    rule: Composition filenames must use kebab-case (lowercase letters, digits, hyphens only)
+    severity: error
+  - id: VIDEO-02
+    rule: Scene durations must use contain mode by default to avoid unexpected cropping
+    severity: warning
+  - id: VIDEO-03
+    rule: All speech audio elements must have corresponding ef-captions elements for accessibility
+    severity: error
+workspace:
+  dirs:
+    - compositions
+    - packages
+    - services
+  files:
+    - path: pnpm-workspace.yaml
+      content: |
+        packages:
+          - "compositions/*"
+          - "packages/*"
+          - "services/*"
+    - path: turbo.json
+      content: |
+        {
+          "$schema": "https://turbo.build/schema.json",
+          "tasks": {
+            "build": {
+              "dependsOn": ["^build"],
+              "outputs": ["dist/**"]
+            },
+            "build:check": {
+              "dependsOn": ["^build:check"]
+            },
+            "test": {
+              "dependsOn": ["^build:check"]
+            }
+          }
+        }
+    - path: .gitignore
+      content: |
+        node_modules
+        dist
+        .turbo
+        .cache
+        operator-profile.md
+    - path: .github/workflows/ci.yml
+      content: |
+        name: CI
+
+        on:
+          pull_request:
+          push:
+            branches: [main]
+          workflow_dispatch:
+
+        concurrency:
+          group: ${{ github.workflow }}-${{ github.ref }}
+          cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+        permissions:
+          contents: read
+
+        jobs:
+          ci:
+            runs-on: ubuntu-latest
+            timeout-minutes: 15
+            name: Lint, type-check, build, test
+            env:
+              TZ: UTC
+
+            steps:
+              - name: Checkout
+                uses: actions/checkout@v5
+
+              - name: Enable Corepack
+                run: corepack enable
+
+              - name: Setup Node.js
+                uses: actions/setup-node@v5
+                with:
+                  node-version: "24"
+                  cache: "pnpm"
+
+              - name: Install dependencies
+                run: pnpm install --frozen-lockfile
+
+              - name: Format check
+                run: pnpm format:check
+
+              - name: Type check
+                run: pnpm build:check
+
+              - name: Build
+                run: pnpm build
+
+              - name: Test
+                run: pnpm test
+
+        # Windows CI (optional — uncomment if Windows checks are needed):
+        #
+        #   windows-ci:
+        #     runs-on: windows-latest
+        #     name: Lint, type-check, build, test (Windows)
+        #     env:
+        #       GIT_CONFIG_COUNT: 1
+        #       GIT_CONFIG_KEY_0: core.longpaths
+        #       GIT_CONFIG_VALUE_0: "true"
+        #     steps:
+        #       - name: Checkout
+        #         uses: actions/checkout@v5
+        #       - name: Enable Corepack
+        #         run: corepack enable
+        #       - name: Setup Node.js
+        #         uses: actions/setup-node@v5
+        #         with:
+        #           node-version: "24"
+        #           cache: "pnpm"
+        #       - name: Install dependencies
+        #         run: pnpm install --frozen-lockfile
+        #       - name: Format check
+        #         run: pnpm format:check
+        #       - name: Type check
+        #         run: pnpm build:check
+        #       - name: Build
+        #         run: pnpm build
+        #       - name: Test
+        #         run: pnpm test
+        #
+        # The GIT_CONFIG_COUNT env block MUST be set before the checkout step
+        # so git can handle long file paths during clone on Windows.
+        # Do not add Windows to the matrix "just in case" — it requires
+        # separate path-length and platform-specific dependency verification.
+    - path: package.json
+      content: |
+        {
+          "name": "__PROJECT_NAME__",
+          "version": "0.1.0",
+          "private": true,
+          "type": "module",
+          "engines": {
+            "node": ">=22"
+          },
+          "scripts": {
+            "clean": "node scripts/clean.mjs",
+            "format": "prettier --write .",
+            "format:check": "prettier --check .",
+            "build": "turbo run build",
+            "build:check": "turbo run build:check",
+            "test": "turbo run test",
+            "upgrade-packages": "pnpm -r up"
+          }
+        }
+    - path: scripts/clean.mjs
+      content: |
+        import { readdir, rm } from "node:fs/promises";
+        import { join } from "node:path";
+        import { fileURLToPath } from "node:url";
+
+        const TARGETS = new Set(["node_modules", ".turbo", "dist", ".cache"]);
+
+        const repoRoot = join(fileURLToPath(import.meta.url), "..", "..");
+
+        async function walk(dir, toDelete) {
+          const entries = await readdir(dir, { withFileTypes: true });
+          for (const entry of entries) {
+            if (!entry.isDirectory()) continue;
+            const name = entry.name;
+            const fullPath = join(dir, name);
+            if (TARGETS.has(name)) {
+              toDelete.push(fullPath);
+              continue;
+            }
+            await walk(fullPath, toDelete);
+          }
+        }
+
+        const toDelete = [];
+        await walk(repoRoot, toDelete);
+
+        if (toDelete.length === 0) {
+          console.log("Nothing to clean.");
+          process.exit(0);
+        }
+
+        await Promise.all(toDelete.map((p) => rm(p, { recursive: true, force: true })));
+
+        for (const p of toDelete) {
+          console.log("deleted", p.replace(repoRoot + "/", ""));
+        }
+
+        console.log(`Cleaned ${toDelete.length} directories.`);
+install:
+  - pnpm add -D @editframe/cli @warpgogol/forge turbo prettier
+firstWorkspace:
+  path: compositions/my-first-video
+  files:
+    - path: package.json
+      content: |
+        {
+          "name": "my-first-video",
+          "version": "0.1.0",
+          "private": true,
+          "type": "module",
+          "scripts": {
+            "preview": "editframe preview",
+            "render": "editframe render -o dist/my-first-video.mp4",
+            "check": "editframe check"
+          }
+        }
+    - path: composition.html
+      content: |
+        <!--
+          Editframe HTML composition — my-first-video
+          This file declares a video composition using Editframe custom elements.
+          Run `editframe preview` to preview, `editframe render` to produce output.
+        -->
+        <ef-timegroup duration="10s">
+          <ef-video
+            src="assets/background.mp4"
+            fit="contain"
+            duration="10s"
+          ></ef-video>
+          <ef-text
+            text="Hello, Editframe!"
+            x="50%"
+            y="50%"
+            font-size="48px"
+            color="white"
+            text-align="center"
+            duration="5s"
+          ></ef-text>
+          <ef-audio
+            src="assets/narration.mp3"
+          ></ef-audio>
+          <ef-captions
+            src="assets/captions.vtt"
+          ></ef-captions>
+        </ef-timegroup>
+  install:
+    - pnpm add -D vitest

package/profiles/forge-shell.yaml

@@ -16,6 +16,83 @@ workspace:
         .turbo
         .cache
         operator-profile.md
+    - path: .github/workflows/ci.yml
+      content: |
+        name: CI
+
+        on:
+          pull_request:
+          push:
+            branches: [main]
+          workflow_dispatch:
+
+        concurrency:
+          group: ${{ github.workflow }}-${{ github.ref }}
+          cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+        permissions:
+          contents: read
+
+        jobs:
+          ci:
+            runs-on: ubuntu-latest
+            timeout-minutes: 15
+            name: Lint, type-check, test
+            env:
+              TZ: UTC
+
+            steps:
+              - name: Checkout
+                uses: actions/checkout@v5
+
+              - name: Enable Corepack
+                run: corepack enable
+
+              - name: Setup Node.js
+                uses: actions/setup-node@v5
+                with:
+                  node-version: "24"
+                  cache: "pnpm"
+
+              - name: Install dependencies
+                run: pnpm install --frozen-lockfile
+
+              - name: Format check
+                run: pnpm format:check
+
+              - name: Test
+                run: pnpm test
+
+        # Windows CI (optional — uncomment if Windows checks are needed):
+        #
+        #   windows-ci:
+        #     runs-on: windows-latest
+        #     name: Lint, type-check, test (Windows)
+        #     env:
+        #       GIT_CONFIG_COUNT: 1
+        #       GIT_CONFIG_KEY_0: core.longpaths
+        #       GIT_CONFIG_VALUE_0: "true"
+        #     steps:
+        #       - name: Checkout
+        #         uses: actions/checkout@v5
+        #       - name: Enable Corepack
+        #         run: corepack enable
+        #       - name: Setup Node.js
+        #         uses: actions/setup-node@v5
+        #         with:
+        #           node-version: "24"
+        #           cache: "pnpm"
+        #       - name: Install dependencies
+        #         run: pnpm install --frozen-lockfile
+        #       - name: Format check
+        #         run: pnpm format:check
+        #       - name: Test
+        #         run: pnpm test
+        #
+        # The GIT_CONFIG_COUNT env block MUST be set before the checkout step
+        # so git can handle long file paths during clone on Windows.
+        # Do not add Windows to the matrix "just in case" — it requires
+        # separate path-length and platform-specific dependency verification.
     - path: package.json
       content: |
         {

package/profiles/phaser-turborepo.yaml

@@ -55,6 +55,93 @@ workspace:
         .turbo
         .cache
         operator-profile.md
+    - path: .github/workflows/ci.yml
+      content: |
+        name: CI
+
+        on:
+          pull_request:
+          push:
+            branches: [main]
+          workflow_dispatch:
+
+        concurrency:
+          group: ${{ github.workflow }}-${{ github.ref }}
+          cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+        permissions:
+          contents: read
+
+        jobs:
+          ci:
+            runs-on: ubuntu-latest
+            timeout-minutes: 15
+            name: Lint, type-check, build, test
+            env:
+              TZ: UTC
+
+            steps:
+              - name: Checkout
+                uses: actions/checkout@v5
+
+              - name: Enable Corepack
+                run: corepack enable
+
+              - name: Setup Node.js
+                uses: actions/setup-node@v5
+                with:
+                  node-version: "24"
+                  cache: "pnpm"
+
+              - name: Install dependencies
+                run: pnpm install --frozen-lockfile
+
+              - name: Format check
+                run: pnpm format:check
+
+              - name: Type check
+                run: pnpm build:check
+
+              - name: Build
+                run: pnpm build
+
+              - name: Test
+                run: pnpm test
+
+        # Windows CI (optional — uncomment if Windows checks are needed):
+        #
+        #   windows-ci:
+        #     runs-on: windows-latest
+        #     name: Lint, type-check, build, test (Windows)
+        #     env:
+        #       GIT_CONFIG_COUNT: 1
+        #       GIT_CONFIG_KEY_0: core.longpaths
+        #       GIT_CONFIG_VALUE_0: "true"
+        #     steps:
+        #       - name: Checkout
+        #         uses: actions/checkout@v5
+        #       - name: Enable Corepack
+        #         run: corepack enable
+        #       - name: Setup Node.js
+        #         uses: actions/setup-node@v5
+        #         with:
+        #           node-version: "24"
+        #           cache: "pnpm"
+        #       - name: Install dependencies
+        #         run: pnpm install --frozen-lockfile
+        #       - name: Format check
+        #         run: pnpm format:check
+        #       - name: Type check
+        #         run: pnpm build:check
+        #       - name: Build
+        #         run: pnpm build
+        #       - name: Test
+        #         run: pnpm test
+        #
+        # The GIT_CONFIG_COUNT env block MUST be set before the checkout step
+        # so git can handle long file paths during clone on Windows.
+        # Do not add Windows to the matrix "just in case" — it requires
+        # separate path-length and platform-specific dependency verification.
     - path: package.json
       content: |
         {

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

@@ -125,8 +125,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:
 
 ```sh
-ref(forge.yaml bindings.commands.scopedBuild) --workspace=ecosystem.manifest.generate
-ref(forge.yaml bindings.commands.scopedBuild) --workspace=command.manifest.generate
+ref(forge.yaml bindings.commands.produce) --workspace=ecosystem.manifest.generate
+ref(forge.yaml bindings.commands.produce) --workspace=command.manifest.generate
 ```
 
 Note: if the regeneration command is expensive or unavailable in the current session, document the need to regenerate in the session summary and move on.
@@ -182,8 +182,8 @@ For each surface that needs updating:
 If any generated artifact needed regeneration (step 2f), run the generator now:
 
 ```sh
-ref(forge.yaml bindings.commands.scopedBuild) --workspace=ecosystem.manifest.generate
-ref(forge.yaml bindings.commands.scopedBuild) --workspace=command.manifest.generate
+ref(forge.yaml bindings.commands.produce) --workspace=ecosystem.manifest.generate
+ref(forge.yaml bindings.commands.produce) --workspace=command.manifest.generate
 ```
 
 If the generator command is unavailable or too expensive for this session, note it in the summary — the operator can regenerate later.
@@ -191,8 +191,8 @@ If the generator command is unavailable or too expensive for this session, note
 If a generated artifact was regenerated, run the drift guards:
 
 ```sh
-ref(forge.yaml bindings.commands.scopedBuild) --workspace=ecosystem.manifest.validate
-ref(forge.yaml bindings.commands.scopedBuild) --workspace=workspace.surface.validate
+ref(forge.yaml bindings.commands.produce) --workspace=ecosystem.manifest.validate
+ref(forge.yaml bindings.commands.produce) --workspace=workspace.surface.validate
 ```
 
 ### 6. Commit

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

@@ -34,8 +34,9 @@ Include:
 - **References to existing artifacts** — specs, plans, ADRs, issues, commits, diffs. Reference them by path or URL instead of duplicating content.
 - **Current state** — what the codebase looks like now, what's uncommitted, what's in progress.
 - **Next steps** — concrete, actionable items the next agent should pick up.
+- **Memory layer pointer** — tell the next agent to read `.agents/memory/MEMORY.md` and recent `.agents/memory/daily/` files for project context.
 
-Do not duplicate content already captured in other artifacts (specs, plans, ADRs, issues, commits, diffs). Reference them by path or URL instead.
+Do not duplicate content already captured in other artifacts (specs, plans, ADRs, issues, commits, diffs). Reference them by path or URL instead. Do not duplicate content from `.agents/memory/` — reference it by path.
 
 Redact any sensitive information, such as API keys, passwords, or personally identifiable information.
 

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

@@ -107,7 +107,7 @@ After **all** plan steps are complete, run the heavy validation suite in order:
 2. **Package-level build checks** for each impacted package:
 
    ```sh
-   ref(forge.yaml bindings.commands.typecheck) --workspace=<package>
+   ref(forge.yaml bindings.commands.validate) --workspace=<package>
    ```
 
 3. **App-level checks** for each impacted app:
@@ -201,6 +201,26 @@ Transition the RFC to `implemented` using the `rfc.implement.stamp` command. Dir
 
    Stage only the RFC file. The implementation commit and the stamp commit MUST be separate.
 
+#### 3.8b. Regenerate command manifest (MANDATORY)
+
+If the RFC added, changed, or removed commands (check `commands.added`, `commands.changed`, `commands.removed` in the RFC frontmatter), regenerate the command manifest so that `rfc.validate` does not report `RFC-CMD-02` (command listed but not registered):
+
+1. Run `ref(forge.yaml bindings.commands.manifestGenerate)`.
+
+2. Commit the regenerated manifest:
+
+   ```txt
+   docs: regenerate command manifest for RFC-XXXX
+
+   Update docs/command-manifest.generated.yaml after RFC-XXXX command changes.
+   ```
+
+   Stage only `docs/command-manifest.generated.yaml`.
+
+If the RFC has no `commands.*` changes (e.g. it only changes schemas, docs, or internal logic), skip this step.
+
+This step is MANDATORY for any RFC with `commands.added`, `commands.changed`, or `commands.removed`. A stale manifest causes `RFC-CMD-02` violations that block `rfc.validate` for all implemented RFCs.
+
 #### 3.9. Documentation audit (fo-doc-audit)
 
 After implementation is complete and all checks pass, invoke `fo-doc-audit` via the `skill` tool. It analyzes the session's changes, checks all documentation surfaces (AGENTS.md, README, Compass XML, architecture-dna.md, templates, generated artifacts, COMMANDS.md/PACKAGE_GRAPH.md), applies needed updates, and commits them separately. Wait for it to complete.
@@ -229,6 +249,17 @@ If `fo-review` (step 3.10) reported **any** findings (even cosmetic ones on axes
 
 If `fo-review` reported truly zero findings (the report explicitly states "No issues." on every axis), skip this step. An `approved` verdict with any finding text on any axis does NOT qualify as zero findings.
 
+#### 3.11b. Implementation status gate (RFC)
+
+Before reporting completion, verify the RFC has been stamped as `implemented`:
+
+1. Read the RFC frontmatter — confirm `status: implemented` and `implementedAt` is set.
+2. Run `ref(forge.yaml bindings.commands.validateRfc) --id RFC-XXXX --json` — confirm zero errors.
+3. If status is not `implemented`, go back to step 3.8 (Stamp implemented) and run the stamp command.
+4. If `rfc.validate` reports errors, fix them before proceeding.
+
+This gate is MANDATORY. Do not proceed to step 3.12 (report) until the RFC is `implemented`.
+
 #### 3.12. RFC report
 
 After implementation is complete, report in `aiLanguage`. **Translate all labels and headings to `aiLanguage`** — the template below is structural only. Only identifiers (RFC-XXXX, file paths, skill names) stay untranslated.
@@ -310,7 +341,7 @@ After implementation is complete, run heavy checks for the impacted workspaces o
 2. Determine impacted packages/apps from the ADR's `scope` and the files touched during implementation. Build only those workspaces:
 
    ```sh
-   ref(forge.yaml bindings.commands.typecheck) --workspace=<package>
+   ref(forge.yaml bindings.commands.validate) --workspace=<package>
    ```
 
    Or for apps:
@@ -412,6 +443,17 @@ After all checks pass and documentation is updated, transition the ADR to `imple
 
    Stage only the ADR file.
 
+#### 4.10b. Implementation status gate (ADR)
+
+Before reporting completion, verify the ADR has been transitioned to `implemented`:
+
+1. Read the ADR frontmatter — confirm `status: implemented` and `implementedAt` is set.
+2. Run `ref(forge.yaml bindings.commands.validateAdr) --id ADR-XXXX --json` — confirm zero errors.
+3. If status is not `implemented`, go back to step 4.10 (Stamp implemented) and set `status: implemented`, `implementedAt`, `updatedAt`.
+4. If `adr.validate` reports errors, fix them before proceeding.
+
+This gate is MANDATORY. Do not proceed to step 4.11 (report) until the ADR is `implemented`.
+
 #### 4.11. Report
 
 After implementation is complete, report in `aiLanguage`. **Translate all labels and headings to `aiLanguage`** — the template below is structural only.

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

@@ -141,6 +141,7 @@ Step ordering follows the contract-first pattern:
 5. **Validation** — run `rfc.validate`, `build:check`, acceptance probes.
 6. **Evidence** — run `rfc.verification.emit`, commit evidence file.
 7. **Review & Fix** — `fo-review` on all session code changes, `fo-fix` if findings (MANDATORY — do not omit from the plan).
+8. **Stamp implemented** — run `rfc.implement.stamp --id RFC-XXXX --implementation-commit <sha>` to transition `accepted → implemented` (RFC). For ADRs, manually set `status: implemented` and `implementedAt` per `fo-idea-implement` step 4.10.
 
 Mark **human review points** on steps that: