@playcraft/cli 0.0.57 → 0.0.58

package/project-template-v2/.claude/snapshot.mjs

@@ -0,0 +1,263 @@
+#!/usr/bin/env node
+/**
+ * snapshot.mjs — Archive current project state + all AI sessions as a git commit + tag
+ *
+ * Usage:
+ *   node snapshot.mjs                              # snapshot cwd project
+ *   node snapshot.mjs <project-path>              # snapshot a specific project
+ *   node snapshot.mjs --project <path>            # same as above, explicit flag
+ *   node snapshot.mjs --name <label>              # custom label for the snapshot commit
+ *   node snapshot.mjs --force                     # skip active-CLI check
+ *
+ * What gets archived:
+ *   All tracked project files (git add -A)
+ *   .playcraft/sessions/  — session JSONL files (main + subagents) from all three stores
+ *                            (Claude Code / Claude Internal / CodeBuddy) matching the project path
+ *
+ * Output: git commit  snapshot: {label} ({MMDD_HHmm})
+ */
+
+import { spawnSync } from 'child_process';
+import { existsSync, readdirSync, statSync, mkdirSync, writeFileSync, rmSync, cpSync } from 'fs';
+import { join, basename, resolve } from 'path';
+import { homedir } from 'os';
+
+// ── helpers ──────────────────────────────────────────────────────────────────
+
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const opts = { project: null, name: null, force: false };
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--project' && args[i + 1]) opts.project = args[++i];
+    else if (args[i] === '--name' && args[i + 1]) opts.name = args[++i];
+    else if (args[i] === '--force') opts.force = true;
+    else if (!args[i].startsWith('--') && !opts.project) opts.project = args[i];
+  }
+  return opts;
+}
+
+function timestamp() {
+  const d = new Date();
+  const pad = n => String(n).padStart(2, '0');
+  return `${pad(d.getMonth() + 1)}${pad(d.getDate())}_${pad(d.getHours())}${pad(d.getMinutes())}`;
+}
+
+function isoNow() {
+  return new Date().toISOString();
+}
+
+// ── active CLI detection ─────────────────────────────────────────────────────
+
+// ── session collection ───────────────────────────────────────────────────────
+
+function findSessions(projectCwd) {
+  const home = homedir();
+  const stores = [
+    { name: 'claude-code',     path: join(home, '.claude', 'projects') },
+    { name: 'codebuddy',       path: join(home, '.codebuddy', 'projects') },
+  ];
+
+  const normalizedCwd = resolve(projectCwd).replace(/\\/g, '/');
+  const slugVariants = [
+    normalizedCwd.replace(/[:/]/g, '-').replace(/\//g, '-'),
+    normalizedCwd.replace(/\\/g, '-').replace(/:/g, '-'),
+  ];
+  const projectName = basename(normalizedCwd);
+
+  const found = [];
+
+  for (const store of stores) {
+    if (!existsSync(store.path)) continue;
+    let projects;
+    try { projects = readdirSync(store.path); } catch { continue; }
+
+    for (const proj of projects) {
+      const projLower = proj.toLowerCase();
+      const matches =
+        projLower.includes(projectName.toLowerCase()) ||
+        slugVariants.some(s => projLower.includes(s.toLowerCase().slice(-30)));
+
+      if (!matches) continue;
+
+      const projPath = join(store.path, proj);
+      let stat;
+      try { stat = statSync(projPath); } catch { continue; }
+      if (!stat.isDirectory()) continue;
+
+      let files;
+      try { files = readdirSync(projPath).filter(f => f.endsWith('.jsonl')); } catch { continue; }
+
+      for (const f of files) {
+        const sessionId = f.replace('.jsonl', '');
+        const sessionFile = join(projPath, f);
+        const subagentsDir = join(projPath, sessionId, 'subagents');
+        found.push({
+          store: store.name,
+          project: proj,
+          sessionId,
+          sessionFile,
+          subagentsDir: existsSync(subagentsDir) ? subagentsDir : null,
+        });
+      }
+    }
+  }
+
+  return found;
+}
+
+function waitForStable(sessionFile, maxRetries = 3, intervalMs = 500) {
+  let lastSize;
+  try { lastSize = statSync(sessionFile).size; } catch { return false; }
+
+  for (let i = 0; i < maxRetries; i++) {
+    const waitUntil = Date.now() + intervalMs;
+    while (Date.now() < waitUntil) { /* spin */ }
+
+    let newSize;
+    try { newSize = statSync(sessionFile).size; } catch { return false; }
+
+    if (newSize === lastSize) return true;
+    lastSize = newSize;
+  }
+
+  return false;
+}
+
+// ── git operations ───────────────────────────────────────────────────────────
+
+function gitExec(cwd, args, env = {}) {
+  const result = spawnSync('git', ['-C', cwd, ...args], {
+    encoding: 'utf8',
+    env: { ...process.env, ...env },
+    stdio: ['ignore', 'pipe', 'pipe'],
+  });
+  if (result.status !== 0) {
+    const errMsg = result.stderr?.trim() || result.stdout?.trim() || 'unknown error';
+    throw new Error(`git ${args[0]} failed: ${errMsg}`);
+  }
+  return result.stdout?.trim() || '';
+}
+
+function gitExecWithRetries(cwd, args, env = {}, maxRetries = 3) {
+  for (let attempt = 1; attempt <= maxRetries; attempt++) {
+    try {
+      return gitExec(cwd, args, env);
+    } catch (err) {
+      if (attempt < maxRetries && err.message.includes('.git/index.lock')) {
+        console.warn(`   ⚠  git index locked, retrying (${attempt}/${maxRetries})...`);
+        const waitUntil = Date.now() + 1000;
+        while (Date.now() < waitUntil) { /* spin */ }
+        continue;
+      }
+      throw err;
+    }
+  }
+}
+
+// ── main ─────────────────────────────────────────────────────────────────────
+
+const opts = parseArgs();
+
+// ── snapshot creation ─────────────────────────────────────────────────────────
+
+const executionCwd = process.cwd();
+const projectDir = opts.project ? resolve(executionCwd, opts.project) : executionCwd;
+const projectName = basename(projectDir);
+const ts = timestamp();
+const label = opts.name || `manual`;
+
+console.log(`\n📦 Snapshotting project: ${projectName}`);
+console.log(`   Source: ${projectDir}\n`);
+
+// 1. Verify .git/ exists
+const gitDir = join(projectDir, '.git');
+if (!existsSync(gitDir)) {
+  console.error(`❌ No .git directory found at ${projectDir}`);
+  console.error('   Snapshot requires a git repository. Use "git init" first.');
+  process.exit(1);
+}
+
+// 2. Active CLI check
+if (!opts.force) {
+  console.warn('   ⚠  Use --force to skip active-CLI check.\n');
+}
+
+// 3. Collect sessions with write stability detection
+console.log('🗂  Finding sessions...');
+const sessions = findSessions(projectDir);
+
+const sessionsDir = join(projectDir, '.playcraft', 'sessions');
+if (existsSync(sessionsDir)) {
+  rmSync(sessionsDir, { recursive: true, force: true });
+}
+mkdirSync(sessionsDir, { recursive: true });
+
+if (sessions.length === 0) {
+  console.log('   ⚠  No sessions found for this project path');
+} else {
+  console.log(`   Found ${sessions.length} session(s):`);
+  for (const s of sessions) {
+    const stable = waitForStable(s.sessionFile);
+    if (!stable) {
+      console.warn(`   ⚠  Session file still being written: ${s.sessionId.slice(0, 8)}… — copying anyway`);
+    }
+
+    const sessionDestDir = join(sessionsDir, s.store, s.project);
+    mkdirSync(sessionDestDir, { recursive: true });
+    cpSync(s.sessionFile, join(sessionDestDir, `${s.sessionId}.jsonl`));
+
+    let subCount = 0;
+    if (s.subagentsDir) {
+      const subDest = join(sessionDestDir, s.sessionId, 'subagents');
+      mkdirSync(subDest, { recursive: true });
+      const subFiles = readdirSync(s.subagentsDir).filter(f => f.endsWith('.jsonl'));
+      for (const sf of subFiles) {
+        cpSync(join(s.subagentsDir, sf), join(subDest, sf));
+        subCount++;
+      }
+    }
+
+    const sizeMB = (statSync(s.sessionFile).size / 1024 / 1024).toFixed(2);
+    console.log(`   ✓ [${s.store}] ${s.sessionId.slice(0, 8)}… (${sizeMB}MB, ${subCount} subagents)`);
+  }
+}
+
+// 4. Write manifest
+const manifest = {
+  createdAt: isoNow(),
+  projectName,
+  projectPath: projectDir,
+  label: opts.name || 'manual',
+  sessionCount: sessions.length,
+  sessions: sessions.map(s => ({
+    store: s.store,
+    project: s.project,
+    sessionId: s.sessionId,
+    hasSubagents: !!s.subagentsDir,
+  })),
+};
+writeFileSync(join(sessionsDir, 'manifest.json'), JSON.stringify(manifest, null, 2));
+
+// 5. Git add all changes (including sessions)
+console.log('\n📝 Staging changes...');
+const GIT_ENV = {
+  GIT_AUTHOR_NAME: 'PlayCraft Snapshot',
+  GIT_AUTHOR_EMAIL: 'snapshot@playcraft.local',
+  GIT_COMMITTER_NAME: 'PlayCraft Snapshot',
+  GIT_COMMITTER_EMAIL: 'snapshot@playcraft.local',
+};
+
+gitExecWithRetries(projectDir, ['add', '-A'], GIT_ENV);
+console.log('   ✓ Staged');
+
+// 6. Commit
+console.log('\n💾 Committing snapshot...');
+const commitMsg = `snapshot: ${label} (${ts})`;
+gitExecWithRetries(projectDir, ['commit', '--allow-empty', '-m', commitMsg], GIT_ENV);
+const commitHash = gitExec(projectDir, ['rev-parse', '--short', 'HEAD']);
+console.log(`   ✓ Commit: ${commitHash}`);
+
+// 7. Summary
+console.log(`\n✅ Snapshot complete!`);
+console.log(`   Hash: ${commitHash}`);
+console.log(`   Sessions archived: ${sessions.length}\n`);

package/project-template-v2/.playcraft/skills.lock.json

@@ -0,0 +1,152 @@
+{
+  "lockVersion": 2,
+  "entries": [
+    {
+      "skillRef": "platform/playcraft-3d-flip-sprite",
+      "version": "1.0.0",
+      "artifactHash": "bfea71413bf9f0b57eda4c79c1c9e5d73061becaf9c1ece066ffcc32890ad1ea",
+      "surface": "portal-agent",
+      "mountPath": ".playcraft/skills/platform__playcraft-3d-flip-sprite"
+    },
+    {
+      "skillRef": "platform/playcraft-asset-management",
+      "version": "1.0.0",
+      "artifactHash": "11ae4c6b1e9e9cb8639e22cfc9568f70cc7fc526bb9632e601e2886ba50fb0f3",
+      "surface": "portal-agent",
+      "mountPath": ".playcraft/skills/platform__playcraft-asset-management"
+    },
+    {
+      "skillRef": "platform/playcraft-build",
+      "version": "1.0.0",
+      "artifactHash": "7fbd4ba060efc9409e8da9aa7d4edfe2cdb2734de7a497b79299a7061cacf3ac",
+      "surface": "portal-agent",
+      "mountPath": ".playcraft/skills/platform__playcraft-build"
+    },
+    {
+      "skillRef": "platform/playcraft-code-editor",
+      "version": "1.0.0",
+      "artifactHash": "4db2b7e60762ba0ccc249ea4023dcb81701dac38d54af0e6757b5337ea489a32",
+      "surface": "portal-agent",
+      "mountPath": ".playcraft/skills/platform__playcraft-code-editor"
+    },
+    {
+      "skillRef": "platform/playcraft-create-remix",
+      "version": "1.0.0",
+      "artifactHash": "76f7cfd4b7441184805e07550f687651225a3baf27e306f0ee7c4347e58f3f19",
+      "surface": "portal-agent",
+      "mountPath": ".playcraft/skills/platform__playcraft-create-remix"
+    },
+    {
+      "skillRef": "platform/playcraft-deploy",
+      "version": "1.0.0",
+      "artifactHash": "e619cee8bea40b2a0c9b69a02d387369a3628a73c0a0504b3c92b1330bc12e86",
+      "surface": "portal-agent",
+      "mountPath": ".playcraft/skills/platform__playcraft-deploy"
+    },
+    {
+      "skillRef": "platform/playcraft-iteration-methodology",
+      "version": "1.0.0",
+      "artifactHash": "42c5219f6f8a8d63787efeef6da8522cf7400442dc75dc8dee6d0c49b0ed28b7",
+      "surface": "portal-agent",
+      "mountPath": ".playcraft/skills/platform__playcraft-iteration-methodology"
+    },
+    {
+      "skillRef": "platform/playcraft-platform-intro",
+      "version": "1.0.0",
+      "artifactHash": "d32001cff62516d343707fdbe4812ed9dde6651c749f2aadc848d06196f07c15",
+      "surface": "portal-agent",
+      "mountPath": ".playcraft/skills/platform__playcraft-platform-intro"
+    },
+    {
+      "skillRef": "platform/playcraft-prefab",
+      "version": "1.0.0",
+      "artifactHash": "7089e5b346ce99dbc25f61e2645e67fce057e6a108445975c99a03b062c84007",
+      "surface": "portal-agent",
+      "mountPath": ".playcraft/skills/platform__playcraft-prefab"
+    },
+    {
+      "skillRef": "platform/playcraft-project-management",
+      "version": "1.0.0",
+      "artifactHash": "32459786cdd17ece2df094be1f13387802325191531939c40c1ddfde3590a17b",
+      "surface": "portal-agent",
+      "mountPath": ".playcraft/skills/platform__playcraft-project-management"
+    },
+    {
+      "skillRef": "platform/playcraft-remix-workflow",
+      "version": "1.0.0",
+      "artifactHash": "07a25c34042dabbde9a166d4e49c977dd8b2459eff27c9c1bc9cafe0a56a08ef",
+      "surface": "portal-agent",
+      "mountPath": ".playcraft/skills/platform__playcraft-remix-workflow"
+    },
+    {
+      "skillRef": "platform/playcraft-save",
+      "version": "1.0.0",
+      "artifactHash": "100d6d66ac449bc8b7f183b8165587bcef6bb5d138d2ddfa07035f229275bc3d",
+      "surface": "portal-agent",
+      "mountPath": ".playcraft/skills/platform__playcraft-save"
+    },
+    {
+      "skillRef": "platform/playcraft-template-upgrade-merge",
+      "version": "1.0.0",
+      "artifactHash": "459e87e02c45b5a859d1c79daf0c53cd7ee9426d6d55ef8d1156a052e557a52f",
+      "surface": "portal-agent",
+      "mountPath": ".playcraft/skills/platform__playcraft-template-upgrade-merge"
+    },
+    {
+      "skillRef": "platform/sound-effects",
+      "version": "1.0.0",
+      "artifactHash": "3a2235197c23ca5b38c46fbb0ff1686f509c094ba206f199f78cdd5f1a07aa95",
+      "surface": "portal-agent",
+      "mountPath": ".playcraft/skills/platform__sound-effects"
+    },
+    {
+      "skillRef": "remix/playcraft-adsdk",
+      "version": "1.0.0",
+      "artifactHash": "9b2e784b167372c6d3e14a3636dac2af8cf64af46c1bef1e082b77c0db51a9c2",
+      "surface": "sandbox-agent",
+      "mountPath": ".playcraft/skills/remix__playcraft-adsdk"
+    },
+    {
+      "skillRef": "remix/playcraft-audio-generation",
+      "version": "1.0.0",
+      "artifactHash": "0f171e4e739d3b1a5b1f00a0b20cf13d0897c69c9d4e30dd3477acd6b982c8c8",
+      "surface": "sandbox-agent",
+      "mountPath": ".playcraft/skills/remix__playcraft-audio-generation"
+    },
+    {
+      "skillRef": "remix/playcraft-dist-publish",
+      "version": "1.0.0",
+      "artifactHash": "0c2396be7fed8b1a0fa2990eee2a23ed9b6abe02ead68c15648f45de7c11e254",
+      "surface": "sandbox-agent",
+      "mountPath": ".playcraft/skills/remix__playcraft-dist-publish"
+    },
+    {
+      "skillRef": "remix/playcraft-image-generation",
+      "version": "1.0.0",
+      "artifactHash": "a7bd5e50c62250f9c84c600239a57d71f197b88d4dedfa9eec6befc10cb4239a",
+      "surface": "sandbox-agent",
+      "mountPath": ".playcraft/skills/remix__playcraft-image-generation"
+    },
+    {
+      "skillRef": "remix/playcraft-image-processing",
+      "version": "1.0.0",
+      "artifactHash": "137ce0b8b76d591148dc0158b5e38abc2fc17f04471fc0d027b0a19d3dde709d",
+      "surface": "sandbox-agent",
+      "mountPath": ".playcraft/skills/remix__playcraft-image-processing"
+    },
+    {
+      "skillRef": "remix/playcraft-prefab",
+      "version": "1.0.0",
+      "artifactHash": "eb1de9851f842e475bb2ae8bb239d5f9b5ab6bd28fe0c83ae96d8570e1a8b814",
+      "surface": "sandbox-agent",
+      "mountPath": ".playcraft/skills/remix__playcraft-prefab"
+    },
+    {
+      "skillRef": "remix/playcraft-remix-workflow",
+      "version": "1.0.0",
+      "artifactHash": "cf5ed218579d49887d6bf2c5f4eb7512ea86684984f57546676df2d6378cd054",
+      "surface": "sandbox-agent",
+      "mountPath": ".playcraft/skills/remix__playcraft-remix-workflow"
+    }
+  ]
+}

package/project-template-v2/CLAUDE.md

@@ -0,0 +1,146 @@
+# PlayCraft Playable Ad Project
+
+这是一个正在制作中的 PlayCraft playable ad 工程,由模板 `project-template-v2` 生成。当前目录不是通用代码库,而是一个会随多 agent 制作流程逐步长出的 playable 项目。
+
+本文件是项目速览:帮助任何 agent 快速理解当前工程形态、入口文件、状态来源和安全边界。它不是调度剧本,也不是状态真源。
+
+## Current Snapshot
+
+- Package: `playcraft-game`, template version `0.4.0-alpha.0`.
+- Runtime stack: Vite + TypeScript.
+- Current pipeline: iteration 1, stage `ideate`, status `pending`.
+- Locked decisions: engine `unset`, coreAction `unset`.
+- Runtime code: `game/index.ts` is still an engine placeholder. Engine scaffold has not been applied yet.
+- Design artifacts are not created yet: `docs/design.md`, `docs/design-brief.md`, `docs/atom-tree.json`, and `docs/todo_list.md` will appear during iteration 1.
+- Optimize verification currently includes `playable-record`, `playable-debug`, and `playable-validate`.
+
+## State Sources
+
+- State command: `npm run state:get` is the normal read entry for current workflow state.
+- Process backing file: `docs/project-state.json` (JSON, JavaScript Object Notation, JavaScript 对象表示法); do not read it directly unless debugging the state scripts.
+- Human view: `docs/project-state.md`, generated from the process backing file.
+- Pipeline specification: `skills/_shared/scripts/pipeline/`.
+- Orchestrator flow: `docs/harness/orchestrator-flow.md`.
+- Stage flow notes: `docs/harness/iteration-1/`.
+- Do not hand-edit `docs/project-state.md`; update state through scripts.
+
+State describes current work; it does not by itself prove which process you are. Use your entry context first, then state.
+
+Main agent entry:
+
+Read `docs/harness/orchestrator-flow.md`.
+
+Named role subagent entry:
+
+```bash
+npm run state:get -- --json dispatch
+```
+
+If `dispatch.role` is not your role, stop and report that no workticket is assigned to you.
+
+## Project Map
+
+### Runtime
+
+- `index.html` - browser document entry (HTML, HyperText Markup Language, 超文本标记语言).
+- `main.ts` - TypeScript entry; imports styles and mounts `startGame("game-container")`.
+- `game/index.ts` - current playable entry. At bootstrap it only displays the engine-not-scaffolded message.
+- `index.css` - global page layout and styling (CSS, Cascading Style Sheets, 层叠样式表).
+- `globals.d.ts` - asset module declarations and `__DEV__` global.
+- `vite.config.ts` - dev/build configuration, asset alias, port preference.
+
+### Assets
+
+- `assets/images/bg/` - background image candidates.
+- `assets/images/ui/` - user interface image candidates.
+- `assets/images/tiles/` - tile or board image candidates.
+- `assets/images/vfx/` - visual effect images.
+- `assets/images/storyboard/` and `assets/images/reference/` - ideation and reference images.
+- `assets/audio/bgm/` and `assets/audio/sfx/` - music and sound effects.
+- `assets/models/` - 3D (Three-Dimensional, 三维) model assets.
+- `assets/bundles/` - generated or packaged asset bundles.
+
+### Project State And Design
+
+- `docs/project-state.json` - process backing file for workflow state; normally read via `npm run state:get`.
+- `docs/project-state.md` - generated state view.
+- `docs/harness/pipeline-design.md` - pipeline v2 design and TODO backlog.
+- `docs/harness/orchestrator-flow.md` - orchestrator runtime loop and dispatch rules.
+- `docs/harness/iteration-1/ideate-flow.md` - design discovery and `docs/design.md` rules.
+- `docs/harness/iteration-1/context-flow.md` - atom-tree and plan-equivalent todo task-card seeding rules.
+- `docs/harness/iteration-1/generate-flow.md` - todo-driven implementation loop.
+- `docs/harness/iteration-1/optimize-flow.md` - build/autoplay/record target and verification skill usage.
+- `docs/harness/iteration-1/wrapup-flow.md` - cleanup and this file refresh rules.
+
+Expected iteration-1 artifacts:
+
+- `docs/design-brief.md` - discovery and brainstorming log.
+- `docs/design.md` - core gameplay design.
+- `docs/atom-tree.json` - selected atom and skills match source.
+- `docs/todo_list.md` - human-readable todo index and cross-todo ref/gap overview.
+
+### Workflow Scripts
+
+- `skills/_shared/scripts/state-get.mjs` - read orchestrator or dispatch state.
+- `skills/_shared/scripts/state-set.mjs` - update state fields.
+- `skills/_shared/scripts/state-advance-stage.mjs` - advance the pipeline stage.
+- `skills/_shared/scripts/todo-add.mjs` / `todo-set.mjs` / `todo-remove.mjs` - manage todo pool.
+- `skills/_shared/scripts/handoff-append.mjs` - append role handoff records.
+- `skills/_shared/scripts/dod-check.mjs` - run DoD (Definition of Done, 完成定义) checks for the current stage.
+- `skills/_shared/scripts/render-project-state.mjs` - render `docs/project-state.md` from JSON state.
+
+### Agent And Skill Context
+
+- `.claude/agents/` - role cards for game-designer, developer, artist, technical-artist, and reviewer.
+- `.claude/agents/refs/` - role reference material.
+- `.claude/skills/` - local skills visible to agents.
+- `.claude/hooks/` - Claude hook scripts.
+- `.claude/settings.json` - hook registration and agent-team environment.
+
+## Common Commands
+
+```bash
+npm run dev
+npm run build
+npm run typecheck
+npm run state:get
+npm run state:get -- --json dispatch
+npm run dispatch:set -- id=<id> role=<role> goal="..."
+npm run dispatch:clear
+npm run todo:add -- id=<id> role=<role> title="..." goal="..." context="..." acceptance="..."
+npm run todo:get -- id=<id>
+npm run todo:set -- id=<id> status=<pending|in_progress|done|failed>
+npm run handoff:append -- role=<role> summary="..." artifactRefs="<files>"
+npm run dod:check
+npm run verify:contract
+npm run verify:firstwin
+npm run verify:fusion
+npm run record:mp4
+npm run verify:vlm-video
+```
+
+Notes:
+
+- `npm run typecheck` requires dependencies to be installed first.
+- `record:mp4` requires Playwright Chromium to be installed; run `npm run record:mp4:install` if the local browser binary is missing.
+
+## Agent Boundaries
+
+- This file is injected into every agent, so keep it as project context only.
+- Main agent reads `npm run state:get` and remains orchestrator.
+- Subagents read `npm run state:get -- --json dispatch`, work within `allowedFiles`, satisfy `acceptance`, then append handoff.
+- Todo status is updated by the orchestrator after reading handoff; subagents do not mark their own todo done.
+- Do not put `stageExit`, `dispatchableRoles`, full todo pools, handoff history, or future-stage plans in this file.
+- Do not infer workflow progress from file presence alone; use `npm run state:get` for workflow state.
+
+## Refresh Policy
+
+Refresh this file during wrapup when the project shape changes. Update:
+
+- current snapshot;
+- runtime entry status;
+- key artifact existence;
+- directory map changes;
+- high-impact known gaps.
+
+Do not copy dynamic workflow history into this file. Detailed process rules belong in `docs/harness/` and `skills/_shared/scripts/pipeline/`.