@erclx/canon 5.44.0 → 5.46.0

package/tooling/web/seeds/e2e/capture/cases.ts

@@ -0,0 +1,47 @@
+import type { CaptureCase, CaptureSection } from '../capture-types'
+
+/** Where a case flagged `evidence: true` writes its committed frames. */
+export const EVIDENCE_ROOT = 'e2e/evidence'
+
+/**
+ * The landing page's own beats, top to bottom. Every entry is a section a
+ * reviewer reads on its own, so a diff lands on the part that moved rather
+ * than on one image of the whole page.
+ */
+const HOME_SECTIONS: CaptureSection[] = [
+  { name: 'top', selector: '#top' },
+  { name: 'proof', selector: '#proof' },
+  { name: 'ask', selector: '#ask' },
+  { name: 'rules', selector: '#rules' },
+  { name: 'skills', selector: '#skills' },
+  { name: 'plan', selector: '#plan' },
+  { name: 'dispatch', selector: '#dispatch' },
+  { name: 'workers', selector: '#workers' },
+  { name: 'gate', selector: '#gate' },
+  { name: 'evidence', selector: '#evidence' },
+  { name: 'loop', selector: '#loop' },
+  { name: 'merge', selector: '#merge' },
+  { name: 'provenance', selector: '#provenance' },
+  { name: 'start', selector: '#start' },
+  { name: 'field', selector: '#field' },
+  { name: 'close', selector: '#close' },
+]
+
+export const CASES: CaptureCase[] = [
+  {
+    section: 'home',
+    theme: 'default',
+    route: '/',
+    evidence: true,
+    mask: ['.version'],
+    sections: HOME_SECTIONS,
+  },
+  {
+    section: 'home',
+    theme: 'dark',
+    route: '/',
+    mask: ['.version'],
+    sections: HOME_SECTIONS,
+    setup: (page) => page.emulateMedia({ colorScheme: 'dark' }),
+  },
+]

package/governance/rules/canon/task-scope.md

@@ -1,12 +0,0 @@
----
-description: Scope, size, and link a task file correctly
----
-
-# Tasks standards
-
-## Task files
-
-- Only create a task for work that spans multiple sessions or has real dependencies. Handle small edits immediately without a task entry.
-- Do not add tasks retroactively for work already completed. Completed work is visible in git.
-- Write a plan in `.canon/plans/` when a task needs execution detail beyond its own file, and link it from the task's intro paragraph.
-- Write that plan in the same session as the task, since the executing session would otherwise re-derive the reasoning behind it.

package/src/commands/wiki.ts

@@ -1,100 +0,0 @@
-import { resolve } from 'node:path'
-import type { Command } from 'commander'
-import { PROJECT_ROOT } from '@/roots/project'
-import {
-  intro,
-  logAdd,
-  logError,
-  logInfo,
-  logStep,
-  logWarn,
-  outro,
-  palette,
-  select,
-} from '@/cli/ui'
-import {
-  applyWikiInit,
-  isWikiTarget,
-  LEGACY_WIKI_DIR_REL,
-  planWikiInit,
-  WIKI_DIR_REL,
-  WIKI_INDEX_REL,
-} from '@/wiki/init'
-
-export function register(program: Command): void {
-  const wiki = program
-    .command('wiki')
-    .description('Wiki commands (init)')
-    .helpOption('-h, --help', 'Show this help message')
-
-  wiki
-    .command('init')
-    .description('Scaffold .claude/wiki/ with a stub index.md')
-    .argument('[target]', 'Target directory', '.')
-    .helpOption('-h, --help', 'Show this help message')
-    .action(async (target: string) => {
-      process.exitCode = await runInit(target)
-    })
-}
-
-async function runInit(target: string): Promise<number> {
-  intro('canon wiki')
-
-  const resolved = resolve(target)
-
-  if (!isWikiTarget(resolved)) {
-    logError(`Target directory not found: ${target}`)
-    outro()
-    return 1
-  }
-
-  if (resolved === PROJECT_ROOT) {
-    logError(
-      'Cannot run against toolkit root. Files here are the source of truth.',
-    )
-    outro()
-    return 1
-  }
-
-  const plan = planWikiInit(resolved)
-  const { GREEN, NC } = palette(process.stderr)
-
-  logStep(`Scanning ${WIKI_DIR_REL}`)
-  if (plan.changes.includes('dir')) logAdd(WIKI_DIR_REL)
-  if (plan.hasIndex) logInfo(WIKI_INDEX_REL)
-  else logAdd(WIKI_INDEX_REL)
-
-  if (plan.hasLegacyWiki) {
-    logWarn(`${LEGACY_WIKI_DIR_REL} found at the target root, not migrated`)
-  }
-
-  const count = plan.changes.length
-  if (count === 0) {
-    outro()
-    process.stderr.write(`${GREEN}✓ Wiki already initialized${NC}\n`)
-    return 0
-  }
-
-  const shouldApply = await select({
-    message: `Apply ${count} change(s)?`,
-    options: [
-      { value: true, label: 'Apply all' },
-      { value: false, label: 'Cancel' },
-    ],
-    nonInteractiveDefault: true,
-  })
-
-  if (!shouldApply) {
-    logWarn('Cancelled')
-    outro()
-    return 0
-  }
-
-  logStep('Applying changes')
-  await applyWikiInit(resolved, plan)
-  if (plan.changes.includes('index')) logAdd(WIKI_INDEX_REL)
-
-  outro()
-  process.stderr.write(`${GREEN}✓ Wiki ready${NC}\n`)
-  return 0
-}

package/src/wiki/init.ts

@@ -1,85 +0,0 @@
-import { existsSync, statSync } from 'node:fs'
-import { mkdir, writeFile } from 'node:fs/promises'
-import { join } from 'node:path'
-
-const WIKI_DIR = join('.claude', 'wiki')
-const LEGACY_WIKI_DIR = 'wiki'
-const INDEX_FILE = 'index.md'
-
-export const WIKI_DIR_REL = `${WIKI_DIR}/`
-export const WIKI_INDEX_REL = join(WIKI_DIR, INDEX_FILE)
-export const LEGACY_WIKI_DIR_REL = `${LEGACY_WIKI_DIR}/`
-
-const INDEX_SEED = `---
-title: Wiki
-subtitle: Reference pages for tools, workflows, and concepts
----
-
-# Wiki
-
-Reference pages for tools, workflows, and concepts.
-`
-
-export type WikiChange = 'dir' | 'index'
-
-export interface WikiPlan {
-  readonly changes: readonly WikiChange[]
-  readonly hasIndex: boolean
-  readonly hasLegacyWiki: boolean
-}
-
-export function wikiDir(target: string): string {
-  return join(target, WIKI_DIR)
-}
-
-/**
- * A target scaffolded before the wiki moved under `.claude/` keeps its pages at
- * the root. The verb reports that folder rather than moving it, because a move
- * is a migration and the `migration-*` skills own those.
- */
-export function legacyWikiDir(target: string): string {
-  return join(target, LEGACY_WIKI_DIR)
-}
-
-/**
- * Stands in for the `cd "$target"` in the bash `guard_root`, which validated
- * the target existed as a side effect. Without it a typo'd path scaffolds a
- * whole new tree, since the apply step creates parents.
- */
-export function isWikiTarget(target: string): boolean {
-  try {
-    return statSync(target).isDirectory()
-  } catch {
-    return false
-  }
-}
-
-/**
- * Reports what a scaffold would create without writing. The directory and the
- * index are tracked separately because a target can carry one without the
- * other, and only the index has content worth preserving.
- */
-export function planWikiInit(target: string): WikiPlan {
-  const dir = wikiDir(target)
-  const index = join(dir, INDEX_FILE)
-  const changes: WikiChange[] = []
-
-  if (!existsSync(dir)) changes.push('dir')
-
-  const hasIndex = existsSync(index)
-  if (!hasIndex) changes.push('index')
-
-  return { changes, hasIndex, hasLegacyWiki: existsSync(legacyWikiDir(target)) }
-}
-
-export async function applyWikiInit(
-  target: string,
-  plan: WikiPlan,
-): Promise<void> {
-  const dir = wikiDir(target)
-  await mkdir(dir, { recursive: true })
-
-  if (plan.changes.includes('index')) {
-    await writeFile(join(dir, INDEX_FILE), INDEX_SEED)
-  }
-}