Skip to content

Add Step 10 mechanical-pass inventories as archaeological reference (#166)#172

Merged
virtualian merged 1 commit into
mainfrom
166-deliver-step10-prose-comparison
May 11, 2026
Merged

Add Step 10 mechanical-pass inventories as archaeological reference (#166)#172
virtualian merged 1 commit into
mainfrom
166-deliver-step10-prose-comparison

Conversation

@virtualian

Copy link
Copy Markdown
Owner

Summary

  • Ships the mechanical first pass of issue Migration: marrair → marrmini, adopt v5.0.0 as baseline, freeze v4.0.3+ #166's Step 10: inventory-pai.txt (674 entries, path-shifted marrair:.pai/ ↔ v5:.claude/ diff) + inventory-claude.txt (162 entries, apples-to-apples marrair:.claude/ ↔ v5:.claude/ diff).
  • Both files carry a header documenting methodology, excludes (runtime ephemera: node_modules/, sessions/, projects/, paste-cache/, file-history/, shell-snapshots/, etc.), and <marrair> / <marrmini-fresh> path tokens for machine portability.

Context

Issue #166's End-to-end Verification gate #5 demanded "every divergent file in inventory-pai.txt and inventory-claude.txt has a category label" plus "8 per-area prose sections present". The parent plan's Step 11 focused-session structure (lines 387–405 of Plans/v5-0-0-is-a-major-keen-wall.md) explicitly authorises descoping the multi-day prose deliverable:

"The plan describes Step 11 as design-doc generation driven by Step 10's multi-day prose report. In practice, a focused session produces a thinner just-enough version sufficient to drive port priorities — without blocking on Step 10's full-prose deliverable."

"The full Step 10 prose report can come later as archaeological reference; it does not block the port work."

This PR delivers the mechanical first pass only, keeping gate #5 partially open by design. The categorisation pass + 8 prose sections remain deferred as archaeological-reference work; the Learning area was separately deep-dived and shipped as reports/v5-learning-loop-vs-pack.md via PR #170. Issue #166 stays closed; the design doc Plans/v5-0-0-plus-port.md carries the decision-grade content needed for port work.

Why now

Surfaces the structural reality (v5 is single-root; v4 fork was two-root) as a committed reference, so future port sessions can grep the inventories rather than regenerate the diff from backups each time.

Test plan

  • wc -l reports/v5-comparison/inventory-pai.txt → 688
  • wc -l reports/v5-comparison/inventory-claude.txt → 180
  • Header methodology block present in both files
  • No raw /Users/ianmarr/backups/... paths; only <marrair>/... and <marrmini-fresh>/... tokens
  • Entry-type breakdown matches expected: 437 marrair-only + 154 v5-only + 83 differ (pai); 38 + 66 + 58 (claude)

…166)

Issue #166's Step 10 required (per End-to-end Verification gate #5) a
runtime-vs-v5 comparison report with categorised inventories and 8
per-area prose sections. The parent plan's Step 11 focused-session
structure (lines 387-405 of Plans/v5-0-0-is-a-major-keen-wall.md)
explicitly authorises descoping the full multi-day prose deliverable:

> "The plan describes Step 11 as design-doc generation driven by
> Step 10's multi-day prose report. In practice, a focused session
> produces a thinner just-enough version sufficient to drive port
> priorities — without blocking on Step 10's full-prose deliverable."
>
> "The full Step 10 prose report can come later as archaeological
> reference; it does not block the port work."

This commit ships the mechanical first pass of gate #5 only:

  reports/v5-comparison/inventory-pai.txt    — 674 entries,
    path-shifted diff marrair:.pai/ ↔ v5:.claude/ (v5 is single-root
    per the design doc's two-root decision, so the literal
    .pai/ ↔ .pai/ diff in the parent plan does not apply).

  reports/v5-comparison/inventory-claude.txt — 162 entries,
    apples-to-apples marrair:.claude/ ↔ v5:.claude/ user-config diff.

Both files carry a header documenting methodology, excludes (runtime
ephemera: node_modules/, sessions/, projects/, paste-cache/,
file-history/, shell-snapshots/, etc.), and the <marrair> /
<marrmini-fresh> path tokens for machine portability.

Not delivered here (deferred as archaeological-only per the plan):
  - 7-label categorisation of every divergent file
  - 8 per-area prose sections (Algorithm, MEMORY, Skills,
    SecurityValidator, PAI-Install/installer engine, AISTEERINGRULES,
    Hooks, Two-root separation)

The Learning area was separately deep-dived and shipped as
reports/v5-learning-loop-vs-pack.md via PR #170.

Gate #5 remains partially open by design; the design doc
(Plans/v5-0-0-plus-port.md) carries the decision-grade content
needed for port work. Issue #166 stays closed.
@virtualian virtualian merged commit 001c703 into main May 11, 2026
@virtualian virtualian deleted the 166-deliver-step10-prose-comparison branch May 11, 2026 06:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant