Skip to content

release: v0.2.0 — symmetrical .ai/ seed, lean foundations, npm publish prep#1

Merged
JasonCheroske merged 9 commits intomainfrom
dev
Apr 6, 2026
Merged

release: v0.2.0 — symmetrical .ai/ seed, lean foundations, npm publish prep#1
JasonCheroske merged 9 commits intomainfrom
dev

Conversation

@JasonCheroske
Copy link
Copy Markdown
Owner

@JasonCheroske JasonCheroske commented Apr 6, 2026

Summary

Ships v0.2.0: symmetrical .ai/ harness namespace in every init, governance ADRs and runbooks, lean foundations reference, first npm publish path, and canonical repo URL alignment (JasonCheroske/Lab-OS).

Highlights

  • Seed: init-lab.mjs copies template/.ai/; generation test asserts .ai/ structure; harness gitignore policy.
  • Governance: ADR-0002 (harness namespace), ADR-0003 (npm create three-option stub), LAB_CONTRACT / COPY_READY_INVENTORY / startup runbook updates; lab-os create stub.
  • Lean: LEAN_FOUNDATIONS.md, modes in FOUNDATIONS_VOCABULARY.md.
  • Release: version 0.2.0, CHANGELOG [0.2.0], RELEASE_NOTES_v0.2.0.md, migration + release runbooks, phase 2 backlog exit criteria for first publish.

Checklist

  • npm test (6/6) green locally
  • CI green on this PR
  • After merge: tag v0.2.0, npm publish per runbooks (when approved)

@JasonCheroske
feat(lab-init): conversation-first design and optional sprout handoff
fb8e33f
@JasonCheroske
docs(seed): expand docs, template sprout layout, and Cursor flow-diag…
edae62a 
…ram skill

- Add /flow-diagram skill (SKILL + reference + examples) and cross-link from
  lab-init; add EXAMPLE_FLOWCHART and LAB_ARCHITECTURE_FLOWCHART with lookup tables.
- Extend reference material: pattern cards maintainer practice, vocabulary updates,
  DOC_INVENTORY/DOCS_MAP, PATTERN_CARD_TEMPLATE.
- Runbooks: adoption guide updates, seed startup runbook, runbook README index.
- Architecture: LAB_CONTRACT adjustments as staged.
- Backlog: lab realignment doc and backlog README.
- Template: root AGENTS/README, docs README and project-structure; README tweaks.
- Tooling: init-lab.mjs and generation.test.mjs changes; root README + CHANGELOG.
@JasonCheroske
Added Document Created & Updated Properties
c940f0e
@JasonCheroske
Checkpoint Pre 0.1.0 Plan Action .AI, Flow-digram Skill
71e380c
@JasonCheroske
feat(seed): symmetrical .ai/ namespace, lean foundations, v0.2.0 rele…
ac5c9ef 
…ase prep

Symmetrical seed:
- init-lab.mjs copies template/.ai/ to target on every init
- template/.ai/ ships harness namespace (skills/, rules/, .cursor/ defaults,
  harness-fetch skill stub); consumer lab investigation deck from day one
- tests/generation.test.mjs: new assertion validates .ai/ paths after init
- template/README.md tree updated; .gitignore adds harness personal artifact policy

Governance:
- ADR-0002: .ai/ harness namespace model, seed vs package, fork policy
- ADR-0003: three-option npm create design (phase 2 stub)
- LAB_CONTRACT: .ai/ added as recommended companion
- COPY_READY_INVENTORY: explicit init includes/excludes, harness gitignore policy
- PRODUCT_LAB_FILTER_RUNBOOK: checklist for archetype promotion gating
- SEED_STARTUP_RUNBOOK: .ai/ harness setup section added
- bin/lab-os.mjs: lab-os create stub command

Lean foundations:
- docs/60-reference/LEAN_FOUNDATIONS.md: seven Poppendieck principles mapped
  to Lab OS mechanisms; research/execution two-mode model
- FOUNDATIONS_VOCABULARY.md: Modes section added

v0.2.0 release prep:
- package.json / package-lock.json: version 0.1.0 → 0.2.0
- CHANGELOG.md: [0.2.0] entry; empty [Unreleased]; all entries documented
- README.md: .ai/ in project tree; npm section live (no Phase 2 label);
  v0.2.0 tar references; release model updated
- RELEASE_NOTES_v0.2.0.md: new
- MIGRATION_CHECKLIST.md: v0.2.0, npm publish steps, scope lock removed
- RELEASE_RUNBOOK.md: npm publish section; phase-only scope lock removed
- PHASE2_PACKAGE_MANAGER_BACKLOG.md: exit criteria met; first publish v0.2.0

Canonical GitHub URLs:
- package.json, CHANGELOG.md, template/root/README.md, template/root/AGENTS.md,
  EXAMPLE_FLOWCHART.md: all aligned to github.com/JasonCheroske/Lab-OS

Made-with: Cursor
@JasonCheroske
fix(ci): expand test globs in lab:verify to work without a shell glob
8d8d8d6 
execFileSync passes argv directly to node, so tests/*.test.mjs was a
literal path and failed GitHub Actions smoke. Enumerate tests/*.test.mjs
under tests/, sort, and pass explicit paths to node --test; exit clearly
if none match.
JasonCheroske
JasonCheroske commented Apr 6, 2026
View reviewed changes
Comment thread .ai/.cursor/skills/flow-diagram/examples.md
@JasonCheroske
feat(docs): automated relative link checks in lab:verify
245bb6a 
- Add scripts/check-doc-links.mjs: scan Markdown (skip fenced blocks),
  validate relative paths; template/root + template/docs merge-aware
  resolution for init output layout
- Wire docs:check-links npm script and run from lab-verify after tests
- Fix .ai skill paths to docs (../../../../) and LAB_ARCHITECTURE_FLOWCHART
  skill link to .ai/.cursor/skills/flow-diagram/SKILL.md
JasonCheroske
JasonCheroske commented Apr 6, 2026
View reviewed changes
Comment thread docs/10-architecture/README.md
@JasonCheroske
feat(docs): git-first frontmatter policy, normalize dates, CI check
3560634 
Script (add-md-frontmatter.mjs):
- normalizePair so created <= updated after git lookup
- --check: fail if any Markdown has inverted ISO dates (CI/agents)
- --fix-order: min/max existing dates without git
- Document modes in file header

Automation:
- lab:verify runs --check after doc link check
- package.json: docs:check-frontmatter

Governance:
- DOC_GOVERNANCE / DOC_INVENTORY: ordering rule, git not editor, modes
- Remove accidental duplicate YAML block in DOC_GOVERNANCE

Bulk: recompute created/updated from git across tracked Markdown (templates,
examples, lab, docs, .ai, template, root readmes).

Made-with: Cursor
@JasonCheroske
Fix(Date Verifer)
e3dbef3
@JasonCheroske JasonCheroske merged commit 724c984 into main Apr 6, 2026
2 checks passed
@JasonCheroske
Copy link
Copy Markdown
Owner Author

JasonCheroske commented Apr 6, 2026

Review complete — approve

I finished review of my PR. Overall it looks good: the seed/harness work, doc-link automation, frontmatter tooling (normalize / --check / stacked-block handling + CRLF), and wiring into lab:verify are coherent and match what we want for CI and agent drift.

I only noticed minor consistency issues during review (mostly around dates / frontmatter shape); nothing blocking. Running everything with “today” as a default was a small semantic loss versus strict git-only semantics, but it’s not something I’d normally retcon in a follow-up unless I decide to tighten policy again.

CI / tests: After the lab:verify glob fix (execFileSync + no shell expansion), all tests passed locally in the same shape as the smoke job.

I’m also going to keep tightening how I implement and review these changes to cut token waste on future passes—ensureing the same outcomes but with a leaner loop.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@JasonCheroske