@warpgogol/forge 0.4.0 → 0.6.0

package/package.json

@@ -1,11 +1,19 @@
 {
   "name": "@warpgogol/forge",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "private": false,
   "type": "module",
   "license": "MIT",
   "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://github.com/syrokomskyi/warpgogol-4#readme",
   "repository": {
     "type": "git",
@@ -15,107 +23,107 @@
   "bugs": {
     "url": "https://github.com/syrokomskyi/warpgogol-4/issues"
   },
-  "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": [
@@ -123,24 +131,17 @@
     "bin/cli.js",
     "skills/",
     "profiles/",
+    "src/onboarding/templates/",
     "os/rfc/rfc-0000-template.md",
     "AGENTS.md",
     "README.md"
   ],
-  "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"
   },
   "devDependencies": {
-    "@types/node": "^26.1.1",
+    "@types/node": "^26.1.2",
     "fast-check": "^4.9.0",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10"
@@ -149,106 +150,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/astro-typescript-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/profiles/editframe-html-templates/composition-agents.md

@@ -0,0 +1,34 @@
+# Composition Workspace
+
+This workspace contains an Editframe video composition.
+
+## Domain terminology
+
+- **Composition** — the artifact this workspace produces (an HTML file using Editframe custom elements).
+- **Scene** — a structural module within a composition (an `ef-timegroup` block).
+- **Director** — the operator who creates and renders the composition.
+
+## Quality invariants
+
+- **VIDEO-01**: Composition filenames must use kebab-case (lowercase letters, digits, hyphens only). This ensures consistent naming across the project. Severity: error.
+- **VIDEO-02**: Scene durations must use `contain` fit mode by default to avoid unexpected cropping of video content. Use `cover` or `fill` only when intentionally overriding the default. Severity: warning.
+- **VIDEO-03**: All speech audio elements (`ef-audio` with speech content) must have corresponding `ef-captions` elements for accessibility. Severity: error.
+
+## Workflow
+
+1. Create a `.html` file with Editframe custom elements (`ef-timegroup`, `ef-video`, `ef-audio`, `ef-text`, `ef-captions`).
+2. Run `editframe preview` to preview the composition in the browser.
+3. Run `editframe check` to validate the composition structure.
+4. Run `editframe render -o dist/<name>.mp4` to produce the final video output.
+
+## Reference template
+
+A sample composition template is available at `editframe-html-templates/composition.html` in the forge profiles directory. Copy it to start a new composition:
+
+```sh
+cp node_modules/@warpgogol/forge/profiles/editframe-html-templates/composition.html compositions/my-new-video/composition.html
+```
+
+## File naming
+
+Composition files use kebab-case: `my-video.html`, `product-demo.html`, `intro-clip.html`.

package/profiles/editframe-html-templates/composition.html

@@ -0,0 +1,32 @@
+<!--
+  Editframe HTML composition template
+  Copy this file to start a new composition. Editframe custom elements:
+  - ef-timegroup: groups elements into a timed sequence
+  - ef-video: video source with fit mode (contain, cover, fill)
+  - ef-audio: audio source
+  - ef-text: text overlay with positioning
+  - ef-captions: accessibility captions for speech audio
+  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="Your text here"
+    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>