theslopmachine 0.6.2 → 0.7.1

package/assets/slopmachine/utils/package_claude_session.mjs

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+
+import fs from 'node:fs/promises'
+import os from 'node:os'
+import path from 'node:path'
+import { spawn } from 'node:child_process'
+
+import { parseArgs, emitFailure, emitSuccess, resolveClaudeSessionPath } from './claude_worker_common.mjs'
+
+const argv = parseArgs(process.argv.slice(2))
+
+async function pathExists(targetPath) {
+  try {
+    await fs.access(targetPath)
+    return true
+  } catch {
+    return false
+  }
+}
+
+async function run(command, args, cwd) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(command, args, { cwd, stdio: ['ignore', 'pipe', 'pipe'], env: process.env })
+    let stdout = ''
+    let stderr = ''
+    child.stdout.on('data', (chunk) => { stdout += chunk.toString() })
+    child.stderr.on('data', (chunk) => { stderr += chunk.toString() })
+    child.on('error', reject)
+    child.on('close', (code) => resolve({ code: code ?? 1, stdout, stderr }))
+  })
+}
+
+async function createZipArchive(sourceDir, outputPath) {
+  await fs.mkdir(path.dirname(outputPath), { recursive: true })
+
+  if (process.platform === 'win32') {
+    const script = [
+      `$src = ${JSON.stringify(path.join(sourceDir, '*'))}`,
+      `$dest = ${JSON.stringify(outputPath)}`,
+      'if (Test-Path $dest) { Remove-Item -Force $dest }',
+      'Compress-Archive -Path $src -DestinationPath $dest -Force',
+    ].join('; ')
+
+    let lastError = null
+    for (const shell of ['pwsh', 'powershell']) {
+      try {
+        const result = await run(shell, [
+          '-NoProfile',
+          '-ExecutionPolicy', 'Bypass',
+          '-Command',
+          script,
+        ], sourceDir)
+
+        if (result.code === 0) {
+          return
+        }
+
+        lastError = new Error((result.stderr || result.stdout).trim() || `zip failed with exit ${result.code}`)
+      } catch (error) {
+        lastError = error
+      }
+    }
+
+    throw lastError || new Error('No usable PowerShell shell was found for zip creation')
+  }
+
+  try {
+    const result = await run('zip', ['-9', '-q', '-r', outputPath, '.'], sourceDir)
+    if (result.code !== 0) {
+      throw new Error((result.stderr || result.stdout).trim() || `zip failed with exit ${result.code}`)
+    }
+  } catch (error) {
+    throw new Error(error instanceof Error ? error.message : 'zip command is required to package Claude sessions')
+  }
+}
+
+async function normalizeClaudeJsonlFiles(projectDir) {
+  const normalizerScript = path.join(path.dirname(new URL(import.meta.url).pathname), 'normalize_claude_session.py')
+  const entries = await fs.readdir(projectDir, { withFileTypes: true }).catch(() => [])
+  const jsonlFiles = entries
+    .filter((entry) => entry.isFile() && entry.name.endsWith('.jsonl'))
+    .map((entry) => path.join(projectDir, entry.name))
+
+  for (const filePath of jsonlFiles) {
+    const tempOutputPath = `${filePath}.normalized`
+    const result = await run('python3', [normalizerScript, filePath, '--output', tempOutputPath], projectDir)
+    if (result.code !== 0) {
+      throw new Error(`Failed to normalize Claude session file ${path.basename(filePath)}: ${(result.stderr || result.stdout).trim()}`)
+    }
+    await fs.rename(tempOutputPath, filePath)
+  }
+}
+
+try {
+  const sessionId = argv['session-id']
+  const transcriptPath = await resolveClaudeSessionPath(sessionId, argv.cwd)
+  if (!(await pathExists(transcriptPath))) {
+    throw new Error(`Claude transcript not found for session ${sessionId}`)
+  }
+
+  const sourceProjectDir = path.dirname(transcriptPath)
+  const tempRoot = await fs.mkdtemp(path.join(os.tmpdir(), 'slopmachine-claude-project-'))
+  const projectDir = path.join(tempRoot, path.basename(sourceProjectDir))
+  await fs.cp(sourceProjectDir, projectDir, { recursive: true })
+  await normalizeClaudeJsonlFiles(projectDir)
+  const included = (await fs.readdir(projectDir).catch(() => [])).sort((left, right) => left.localeCompare(right))
+
+  try {
+    await createZipArchive(projectDir, argv.output)
+    emitSuccess(sessionId, {
+      output: argv.output,
+      project_dir: sourceProjectDir,
+      label: argv.label || null,
+      included,
+      normalized: true,
+    })
+  } finally {
+    await fs.rm(tempRoot, { recursive: true, force: true }).catch(() => {})
+  }
+} catch (error) {
+  emitFailure('package_claude_session_failed', error instanceof Error ? error.message : String(error))
+  process.exitCode = 1
+}

package/assets/slopmachine/utils/prepare_strict_audit_workspace.mjs

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+
+import fs from 'node:fs/promises'
+import path from 'node:path'
+
+import { emitFailure, emitSuccess, parseArgs } from './claude_worker_common.mjs'
+
+const argv = parseArgs(process.argv.slice(2))
+
+function resolveLinkType(targetPath) {
+  return process.platform === 'win32' ? 'junction' : 'dir'
+}
+
+async function pathExists(targetPath) {
+  try {
+    await fs.access(targetPath)
+    return true
+  } catch {
+    return false
+  }
+}
+
+async function ensureLinkedDir(targetPath, linkPath) {
+  await fs.mkdir(path.dirname(linkPath), { recursive: true })
+  await fs.symlink(targetPath, linkPath, resolveLinkType(targetPath))
+}
+
+try {
+  const workspaceRoot = argv['workspace-root'] ? path.resolve(argv['workspace-root']) : null
+  const name = argv.name || 'strict-audit'
+  const auditRoot = argv['output-dir']
+    ? path.resolve(argv['output-dir'])
+    : path.join(workspaceRoot || '', '.ai', 'audit-workspaces', name)
+
+  if (!workspaceRoot) {
+    throw new Error('Missing --workspace-root')
+  }
+
+  const repoDir = path.join(workspaceRoot, 'repo')
+  const tmpDir = path.join(workspaceRoot, '.tmp')
+  if (!(await pathExists(repoDir))) {
+    throw new Error(`Missing repo directory at ${repoDir}`)
+  }
+  if (!(await pathExists(tmpDir))) {
+    throw new Error(`Missing .tmp directory at ${tmpDir}`)
+  }
+
+  await fs.rm(auditRoot, { recursive: true, force: true })
+  const runDir = path.join(auditRoot, 'run')
+  await fs.mkdir(runDir, { recursive: true })
+
+  await ensureLinkedDir(repoDir, path.join(runDir, 'repo'))
+  await ensureLinkedDir(tmpDir, path.join(auditRoot, '.tmp'))
+
+  emitSuccess(null, {
+    workspace_root: workspaceRoot,
+    audit_root: auditRoot,
+    run_dir: runDir,
+    repo_path: path.join(runDir, 'repo'),
+    tmp_path: path.join(auditRoot, '.tmp'),
+  })
+} catch (error) {
+  emitFailure('prepare_strict_audit_workspace_failed', error instanceof Error ? error.message : String(error))
+  process.exitCode = 1
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "theslopmachine",
-  "version": "0.6.2",
+  "version": "0.7.1",
   "description": "SlopMachine installer and project bootstrap CLI",
   "license": "MIT",
   "type": "module",

package/src/constants.js

@@ -62,17 +62,56 @@ export const CLAUDE_REQUIRED_AGENT_FILES = ["developer.md"];
 export const REQUIRED_SLOPMACHINE_FILES = [
   "backend-evaluation-prompt.md",
   "frontend-evaluation-prompt.md",
+  "test-coverage-prompt.md",
   "workflow-init.js",
   "templates/AGENTS.md",
+  "templates/CLAUDE.md",
   "utils/claude_worker_common.mjs",
+  "utils/claude_live_common.mjs",
+  "utils/claude_live_channel.mjs",
+  "utils/claude_live_hook.py",
+  "utils/claude_live_launch.mjs",
+  "utils/claude_live_turn.mjs",
+  "utils/claude_live_status.mjs",
+  "utils/claude_live_stop.mjs",
   "utils/claude_create_session.mjs",
   "utils/claude_resume_session.mjs",
   "utils/claude_export_session.mjs",
   "utils/export_ai_session.mjs",
-  "utils/prepare_ai_session_for_convert.mjs",
-  "utils/convert_exported_ai_session.mjs",
+  "utils/package_claude_session.mjs",
+  "utils/prepare_strict_audit_workspace.mjs",
+  "utils/claude_wait_for_rate_limit_reset.mjs",
+  "utils/claude_wait_for_rate_limit_reset.sh",
+  "utils/normalize_claude_session.py",
+  "scaffold-playbooks/docker-shared-contract.md",
+  "scaffold-playbooks/generic-unknown-tech-guide.md",
+  "scaffold-playbooks/frontend-family-matrix.md",
+  "scaffold-playbooks/backend-family-matrix.md",
+  "scaffold-playbooks/database-module-matrix.md",
+  "scaffold-playbooks/platform-family-matrix.md",
+  "scaffold-playbooks/overlay-module-matrix.md",
+  "scaffold-playbooks/selection-matrix.md",
+  "scaffold-playbooks/docker-baseline.md",
+  "scaffold-playbooks/frontend-baseline.md",
+  "scaffold-playbooks/backend-baseline.md",
+  "scaffold-playbooks/vue-vite-default.md",
+  "scaffold-playbooks/angular-default.md",
+  "scaffold-playbooks/fastapi-default.md",
+  "scaffold-playbooks/spring-boot-default.md",
+  "scaffold-playbooks/django-default.md",
+  "scaffold-playbooks/laravel-default.md",
+  "scaffold-playbooks/livewire-default.md",
+  "scaffold-playbooks/go-chi-default.md",
+  "scaffold-playbooks/web-default.md",
+  "scaffold-playbooks/android-native-java.md",
+  "scaffold-playbooks/android-kotlin-compose.md",
+  "scaffold-playbooks/expo-react-native-default.md",
+  "scaffold-playbooks/electron-vite-default.md",
+  "scaffold-playbooks/tauri-default.md",
+  "scaffold-playbooks/ios-linux-portable.md",
+  "scaffold-playbooks/ios-native-swift.md",
+  "scaffold-playbooks/ios-native-objective-c.md",
   "utils/strip_session_parent.py",
-  "utils/convert_ai_session.py",
   "utils/cleanup_delivery_artifacts.py",
 ];
 

package/src/init.js

@@ -25,11 +25,12 @@ const GITIGNORE_ENTRIES = [
 ]
 
 const ALLOWED_EXISTING_ENTRIES = new Set(['.DS_Store', '.git'])
-const INITIAL_COMMIT_PATHS = ['.gitignore', 'docs', 'metadata.json', 'repo', 'self_test_reports', 'sessions']
+const INITIAL_COMMIT_PATHS = ['.gitignore', '.tmp', 'docs', 'metadata.json', 'repo', 'sessions']
 const ADOPTION_ROOT_KEEP = new Set([
   '.DS_Store',
   '.git',
   '.gitignore',
+  '.tmp',
   '.ai',
   '.beads',
   'docs',
@@ -37,7 +38,19 @@ const ADOPTION_ROOT_KEEP = new Set([
   'metadata.json',
   'repo',
 ])
-const VALID_START_PHASES = new Set(['P0', 'P1', 'P2', 'P3', 'P4', 'P5', 'P6', 'P7', 'P8', 'P9', 'P10'])
+const VALID_START_PHASES = new Set(['P1', 'P2', 'P3', 'P4', 'P5', 'P6', 'P7', 'P8', 'P9', 'P10'])
+const PHASE_LABELS = {
+  P1: 'P1 Clarification',
+  P2: 'P2 Planning',
+  P3: 'P3 Scaffold',
+  P4: 'P4 Development',
+  P5: 'P5 Integrated Verification',
+  P6: 'P6 Hardening',
+  P7: 'P7 Evaluation and Fix Verification',
+  P8: 'P8 Final Human Decision',
+  P9: 'P9 Submission Packaging',
+  P10: 'P10 Retrospective',
+}
 
 function getUnixBrCommandCandidates(paths) {
   return [
@@ -281,7 +294,24 @@ async function createInitialPhaseArtifacts(targetPath, options) {
     `Capture the planning-critical project shape here before real planning begins.\n\n` +
     `## Bootstrap Notes\n\n` +
     `${options.adoptExisting ? '- This workspace was adopted from an existing project. Inspect the current codebase state before assuming a clean-slate build.\n' : '- This workspace started from a clean slopmachine bootstrap.\n'}` +
-    `${options.requestedStartPhase ? `- Requested start phase: ${options.requestedStartPhase}.\n` : ''}`
+    `${options.requestedStartPhase ? `- Requested start phase: ${options.requestedStartPhase}.\n` : ''}` +
+    `\n## Intake Shape\n\n` +
+    `Fill this file with concise but concrete planning inputs:\n\n` +
+    `- prompt-critical requirements\n` +
+    `- actors and path-to-success summaries\n` +
+    `- required surfaces\n` +
+    `- explicit out-of-scope items\n` +
+    `- locked defaults\n` +
+    `- major risks\n` +
+    `- shared prerequisites and likely parallel work packages\n` +
+    `\n## Gap Sweep\n\n` +
+    `Before planning, note the important unresolved gaps in these categories when relevant:\n\n` +
+    `- business rules\n` +
+    `- workflows\n` +
+    `- data model\n` +
+    `- security and compliance\n` +
+    `- reliability / offline / retries\n` +
+    `- reporting / exports / analytics\n`
 
   const clarificationOptionsContent = `# Clarification Options\n\n` +
     `## Original Prompt\n\n` +
@@ -293,32 +323,128 @@ async function createInitialPhaseArtifacts(targetPath, options) {
     `Build the developer-facing clarification prompt here once P1 resolves the material ambiguities.\n`
 
   const designContent = `# Design\n\n` +
-    `This document is the owner-maintained external design reference for the project.\n\n` +
+    `This document is the owner-maintained external design reference for the project. Treat it as the authoritative detailed planning and design contract once planning begins.\n\n` +
     `## Bootstrap Notes\n\n` +
     `${options.adoptExisting ? '- This workspace was adopted from an existing project. Update this design reference to match the real codebase state before planning deeply.\n' : '- This workspace started from a clean slopmachine bootstrap. Update this file as clarification and planning progress.\n'}` +
-    `${options.requestedStartPhase ? `- Requested start phase: ${options.requestedStartPhase}.\n` : ''}`
+    `${options.requestedStartPhase ? `- Requested start phase: ${options.requestedStartPhase}.\n` : ''}` +
+    `\n## How To Use This File\n\n` +
+    `- Replace placeholders with concrete implementation decisions.\n` +
+    `- Do not leave major sections vague, empty, or deferred without an explicit reason.\n` +
+    `- Prefer explicit tables, bullet lists, and subsections over broad narrative.\n` +
+    `- Make this detailed enough that scaffold and development can mostly execute by following the accepted plan.\n` +
+    `\n## Tech Stack Summary\n\n` +
+    `State the concrete backend, frontend, persistence, auth/security, jobs/async, runtime, and other major stack choices here. If something is intentionally not fixed yet, say so explicitly and explain why.\n` +
+    `\n## Product Overview\n\n` +
+    `Describe what is being built, for whom, and the core business objective in implementation-relevant language.\n` +
+    `\n## System Overview\n\n` +
+    `- What is being built\n` +
+    `- Core business objective\n` +
+    `- Primary technical shape\n` +
+    `\n## In-Scope Domains\n\n` +
+    `List the major domains or modules that are part of delivery.\n` +
+    `\n## Explicit Out-Of-Scope\n\n` +
+    `List what is intentionally not being built so implementation does not overreach.\n` +
+    `\n## Actors And Roles\n\n` +
+    `Define the user types, admins, operators, and other actors.\n` +
+    `\n## Actor Success Paths\n\n` +
+    `For each important actor, define the concrete path to success for the prompt-critical workflows.\n` +
+    `\n## Architecture And Module Boundaries\n\n` +
+    `Describe the major components, boundaries, and why this structure was chosen.\n` +
+    `\n## Domain Model And Data Model\n\n` +
+    `List the important entities, relationships, supporting records, and persistence constraints.\n` +
+    `\n## Authoritative Business Rules\n\n` +
+    `Define defaults, limits, formulas, uniqueness rules, conflicts, retries, reversals, ownership rules, and other critical domain rules.\n` +
+    `\n## State Machines And Lifecycles\n\n` +
+    `Define the allowed states, transitions, triggers, and illegal transitions where workflow state matters.\n` +
+    `\n## Permissions And Authorization Model\n\n` +
+    `Define roles, scopes, route-level checks, object-level checks, and privileged actions.\n` +
+    `\n## Validation And Error Handling\n\n` +
+    `Define the important validations, normalized errors, and failure behavior.\n` +
+    `\n## Security, Compliance, And Data Governance\n\n` +
+    `Describe authentication, session or token rules, audit expectations, masking, retention, deletion, export restrictions, and other sensitive-data controls when relevant.\n` +
+    `\n## Offline, Queueing, Reliability, And Background Jobs\n\n` +
+    `When relevant, define queue behavior, retries, resumability, conflict handling, job states, observability, and maintenance behavior.\n` +
+    `\n## Reporting, Analytics, Search, And Exports\n\n` +
+    `When relevant, describe KPIs, source of truth, calculations, indexing or search behavior, export rules, and report job lifecycles.\n` +
+    `\n## Runtime, Config, And Ops Contract\n\n` +
+    `Define runtime entrypoints, config flow, environment handling, jobs, observability, and operational expectations.\n` +
+    `\n## Interface Contracts\n\n` +
+    `Describe important APIs, frontend/backend contracts, payload shapes, and user-visible interaction expectations.\n` +
+    `\n## Non-Functional Requirements\n\n` +
+    `Describe performance, deterministic behavior, restart recovery, availability, timezone, backup, and other cross-cutting quality requirements when relevant.\n` +
+    `\n## Verification Strategy\n\n` +
+    `Describe the local verification model, broad-gate verification, and the major risk-to-test expectations.\n` +
+    `\n## Dependency And Parallelism Plan\n\n` +
+    `Identify which work must stay serial because of shared foundations, and which 2 or 3 work packages can safely proceed in parallel once those foundations are settled.\n` +
+    `\n## Implementation Phases\n\n` +
+    `Break the work into realistic phases or major chunks with dependencies and usable outcomes.\n` +
+    `\n## Phase Checkpoints\n\n` +
+    `For each phase, define required artifacts, required working flows, required tests, exit criteria, and what is not allowed to defer past that phase.\n` +
+    `\n## Definition Of Done\n\n` +
+    `Define the hard completion standard that should block fake-complete or scaffold-only delivery.\n` +
+    `\n## Deliverables\n\n` +
+    `List the concrete outputs delivery must produce, such as working application, scripts, tests, docs, bootstrap assets, exports, or admin tools when relevant.\n` +
+    `\n## Assumptions, Dispositions, And Open Items\n\n` +
+    `Keep unresolved items rare. Each section should be either concrete or explicitly marked not applicable with a reason. If something is still open, name it explicitly, explain why it is still open, and state what evidence or decision is needed to close it.\n`
 
   const apiSpecContent = `# API Spec\n\n` +
     `Use this owner-maintained external document when API or interface contracts are material to the project.\n\n` +
     `If the project has no meaningful API surface, mark this file as not applicable rather than deleting it silently.\n`
 
   const testCoverageContent = `# Test Coverage\n\n` +
-    `Map prompt-critical requirements and risks to concrete tests here as the project evolves.\n\n` +
-    `## Expected Shape\n\n` +
+    `Map prompt-critical requirements, endpoint coverage, and audit-facing test evidence here as the project evolves.\n\n` +
+    `## Requirement And Risk Matrix\n\n` +
     `- Requirement or risk\n` +
     `- Test file or layer\n` +
     `- Key assertion\n` +
     `- Coverage status\n` +
+    `- Remaining gap\n\n` +
+    `## Backend Endpoint Inventory\n\n` +
+    `Use this when the project exposes backend or fullstack API endpoints.\n\n` +
+    `- Method\n` +
+    `- Resolved path\n` +
+    `- Notes\n\n` +
+    `## API Test Mapping Table\n\n` +
+    `- Endpoint\n` +
+    `- Covered: yes/no\n` +
+    `- Test type: true no-mock HTTP / HTTP with mocking / unit-only or indirect\n` +
+    `- Test file\n` +
+    `- Evidence\n\n` +
+    `## Unit Test Summary\n\n` +
+    `- Module family\n` +
+    `- Covered by\n` +
+    `- Important modules not tested\n\n` +
+    `## Coverage Summary\n\n` +
+    `- Total endpoints\n` +
+    `- Endpoints with HTTP tests\n` +
+    `- Endpoints with true no-mock HTTP tests\n` +
+    `- Coverage threshold target\n` +
     `- Remaining gap\n`
 
   const repoReadmeContent = `# Project\n\n` +
     `This README is the primary in-repo documentation surface.\n\n` +
-    `Fill in:\n\n` +
-    `- what the project does\n` +
-    `- how to run it\n` +
-    `- how to test it\n` +
-    `- the main repo contents\n` +
-    `- important information a new developer needs immediately\n`
+    `## Project Type\n\n` +
+    `State one of: backend, fullstack, web, android, ios, desktop.\n\n` +
+    `## Overview\n\n` +
+    `Explain what the project does and who it is for.\n\n` +
+    `## Tech Stack\n\n` +
+    `List the main frameworks, languages, and runtime pieces.\n\n` +
+    `## Startup Instructions\n\n` +
+    `Document the canonical startup path and any audit-compatibility or platform-specific launch notes.\n\n` +
+    `## Access Method\n\n` +
+    `Explain how a reviewer reaches the system after startup.\n\n` +
+    `## Verification Method\n\n` +
+    `Explain how to confirm the main flows actually work.\n\n` +
+    `## Authentication\n\n` +
+    `Provide demo credentials for every role, or state exactly: No authentication required\n\n` +
+    `## Roles And Workflows\n\n` +
+    `Summarize the important roles, main workflows, and any security-relevant behavior a reviewer should know.\n\n` +
+    `## Main Repo Contents\n\n` +
+    `List the main directories, entry points, and scripts.\n\n` +
+    `## Architecture\n\n` +
+    `Summarize the delivered architecture and major implementation structure.\n\n` +
+    `## Important Notes\n\n` +
+    `Document feature flags, mock/default behavior, setup boundaries, and important new-developer information.\n`
 
   const startupContextContent = `# Startup Context\n\n` +
     `- Bootstrap mode: ${options.adoptExisting ? 'adopt-existing-project' : 'new-workspace'}\n` +
@@ -338,14 +464,17 @@ async function createInitialPhaseArtifacts(targetPath, options) {
 }
 
 async function createRepoStructure(targetPath, agentsTemplate, options) {
+  const initialPhase = options.requestedStartPhase ? PHASE_LABELS[options.requestedStartPhase] : 'P1 Clarification'
+
   log('Creating parent workflow directories')
+  await ensureDir(path.join(targetPath, '.tmp'))
   await ensureDir(path.join(targetPath, 'docs'))
   await ensureDir(path.join(targetPath, 'sessions'))
-  await ensureDir(path.join(targetPath, 'self_test_reports'))
-  await ensureDir(path.join(targetPath, '.ai', 'claude-traces'))
+  await ensureDir(path.join(targetPath, '.ai', 'claude-live'))
 
   log('Creating repo/ working directory')
   await ensureDir(path.join(targetPath, 'repo'))
+  await ensureDir(path.join(targetPath, 'repo', '.claude'))
 
   log('Copying AGENTS template into repo/')
   const repoAgentsPath = path.join(targetPath, 'repo', 'AGENTS.md')
@@ -354,6 +483,17 @@ async function createRepoStructure(targetPath, agentsTemplate, options) {
   }
   await fs.copyFile(agentsTemplate, repoAgentsPath)
 
+  await writeFileIfMissing(
+    path.join(targetPath, 'repo', '.claude', 'settings.json'),
+    `${JSON.stringify({
+      $schema: 'https://json.schemastore.org/claude-code-settings.json',
+      agent: 'developer',
+      env: {
+        CLAUDE_CODE_SUBAGENT_MODEL: 'sonnet',
+      },
+    }, null, 2)}\n`,
+  )
+
   const projectMetadataPath = path.join(targetPath, 'metadata.json')
   if (!(await pathExists(projectMetadataPath))) {
     log('Creating parent metadata.json')
@@ -373,35 +513,40 @@ async function createRepoStructure(targetPath, agentsTemplate, options) {
 
   const workflowMetadataPath = path.join(targetPath, '.ai', 'metadata.json')
   if (!(await pathExists(workflowMetadataPath))) {
-    log('Creating .ai/metadata.json')
-    await fs.writeFile(workflowMetadataPath, `${JSON.stringify({
-      run_id: randomUUID(),
-      current_phase: 'P1 Clarification',
-      awaiting_human: false,
+      log('Creating .ai/metadata.json')
+      await fs.writeFile(workflowMetadataPath, `${JSON.stringify({
+        run_id: randomUUID(),
+        current_phase: initialPhase,
+        awaiting_human: false,
       clarification_approved: false,
       clarification_validator_session_id: null,
       evaluation_prompt_kind: null,
       active_evaluator_session_id: null,
-      self_test_reports_root: 'self_test_reports',
-      self_test_successful_cycle_count: 0,
-      self_test_cycles: [],
-      failed_audit_count: 0,
-      failed_audits: [],
+      evaluation_reports_root: '.tmp',
+      evaluation_audit_count: 0,
+      evaluation_runs: [],
+      completed_bugfix_session_count: 0,
+      required_bugfix_session_count: 2,
+      coverage_readme_audit_completed: false,
+      coverage_readme_audit_report_path: null,
       developer_sessions: [],
+      developer_rulebook_file: null,
       current_developer_lane: null,
       active_developer_session_id: null,
+      primary_develop_session_id: null,
+      latest_develop_session_id: null,
       next_develop_session_number: 1,
       next_bugfix_session_number: 1,
       packaging_completed: false,
-      claude_trace_root: '.ai/claude-traces',
+      claude_live_root: '.ai/claude-live',
       bootstrap_mode: options.adoptExisting ? 'adopt' : 'new',
       requested_start_phase: options.requestedStartPhase,
     }, null, 2)}\n`, 'utf8')
   }
 
   await fs.writeFile(path.join(targetPath, '.ai', 'artifacts', '.gitkeep'), '', 'utf8')
-  await fs.writeFile(path.join(targetPath, '.ai', 'claude-traces', '.gitkeep'), '', 'utf8')
-  await fs.writeFile(path.join(targetPath, 'self_test_reports', '.gitkeep'), '', 'utf8')
+  await fs.writeFile(path.join(targetPath, '.ai', 'claude-live', '.gitkeep'), '', 'utf8')
+  await fs.writeFile(path.join(targetPath, '.tmp', '.gitkeep'), '', 'utf8')
   await fs.writeFile(path.join(targetPath, 'sessions', '.gitkeep'), '', 'utf8')
 
   await createInitialPhaseArtifacts(targetPath, options)