[Tracking] Open your own project (MVP)

[lex00]

Tracking issue for the "open your own project" goal: let behold open an arbitrary chant project directory instead of always defaulting to the bundled Loom demo (../loomster on the Floci emulator).

behold already shells the project's own chant binary and paints the returned IR, and the serve command already takes arbitrary project dirs — so the base source graph renders for any chant project today. The coupling to Loom is thin and localized; these issues remove it and make the feature usable on real (imperfect) projects.

MVP checklist

• Open your own project: remove auto-Loom defaulting from the CLI #69 — Remove auto-Loom defaulting from the CLI (anchor; gates Floci/emulator env behind an explicit flag)
• Source deploy tiers from chant.config.ts instead of hardcoded LOOM_TIER #70 — Source deploy tiers from chant.config.ts instead of hardcoded LOOM_TIER / ["light","production","production-ha"]
• Honor chant.config.ts sourceDir/stacks in graph resolution (graphPath) #71 — Honor chant.config.ts sourceDir/stacks in graphPath() (currently hardcoded to a literal src/)
• Graceful entry/error screen for precondition failures (lint gate, not installed, creds) #72 — Graceful entry/error screen for precondition failures (lint gate, not-installed/typegen, creds)

Sequencing

• Open your own project: remove auto-Loom defaulting from the CLI #69 is the anchor — start here. Source deploy tiers from chant.config.ts instead of hardcoded LOOM_TIER #70, Honor chant.config.ts sourceDir/stacks in graph resolution (graphPath) #71, Graceful entry/error screen for precondition failures (lint gate, not installed, creds) #72 are independent of each other and can run in parallel once Open your own project: remove auto-Loom defaulting from the CLI #69's flag design is settled.
• Open your own project: remove auto-Loom defaulting from the CLI #69 and Source deploy tiers from chant.config.ts instead of hardcoded LOOM_TIER #70 each introduce a new convention — the emulator opt-in flag (--emulator vs --local) and where a project declares tiers. Pin those decisions before the agent starts so it isn't guessing.

Test target

../loomster — a genuine, standalone chant project with no behold coupling (chant.config.ts satisfies ChantConfig; lexicons aws/docker/temporal; ~7 stacks / ~63 AWS resources; sourceDir: "src"). Opening it via an explicit path exercises the generic path; the explicit emulator invocation must still reproduce today's turnkey demo.

Related (not blocking the MVP)

• Add a ⌘K command palette and thin the on-screen chrome (port spicypath pattern) #73 — ⌘K command palette + thin the chrome (UI, independent)
• Non-AWS substrate parity for live/drift/logical/reconcile layers (tracking) #74 — Non-AWS substrate parity for live/drift/logical/reconcile (follow-on track)

[lex00]

Open decisions resolved

Both pre-handoff decisions are now pinned:

• Emulator flag → --emulator (pinned in Open your own project: remove auto-Loom defaulting from the CLI #69)
• Tier source → a separate .behold.json in the project root, shape { "tiers": { "envVar", "values" } }; no file → no tier axis (pinned in Source deploy tiers from chant.config.ts instead of hardcoded LOOM_TIER #70)

No blockers remain for an agent to start on #69.

[lex00]

MVP shipped ✅

All four MVP issues merged to main (commit e3af012) via a conflict-resolved merge train — full gate green (tsc + 242 tests + build):

• Open your own project: remove auto-Loom defaulting from the CLI #69 → feat(cli): remove auto-Loom defaulting; gate the emulator env behind --emulator #77 — de-Loom CLI, --emulator flag
• Source deploy tiers from chant.config.ts instead of hardcoded LOOM_TIER #70 → feat(project): source deploy tiers from .behold.json (#70) #79 — tiers from .behold.json
• Honor chant.config.ts sourceDir/stacks in graph resolution (graphPath) #71 → feat(chant): honor chant.config.ts sourceDir in graph resolution #78 — honor sourceDir in graphPath (multi-stack deferred → Render multi-stack (stacks[]) projects in graph resolution #76)
• Graceful entry/error screen for precondition failures (lint gate, not installed, creds) #72 → feat: graceful entry/error screen for chant precondition failures (#72) #81 — structured precondition error screens

Also merged alongside: #73 → #80 (⌘K command palette + thinned chrome).

Follow-ups still open: #74 (non-AWS substrate parity, tracking), #76 (multi-stack stacks[] rendering).

Remaining manual step for the demo: add a .behold.json to the loomster repo so behold preview ../loomster --emulator keeps surfacing its three tiers:

{ "tiers": { "envVar": "LOOM_TIER", "values": ["light", "production", "production-ha"] } }

[lex00]

Closing — the MVP shipped in e3af012 (see the status comment above), and the one manual step it left open is now done too.

All four checklist items are merged: #69 (de-Loom CLI, --emulator), #70 (tiers from .behold.json), #71 (sourceDir in graphPath), #72 (precondition error screens).

The remaining step that comment named — adding a .behold.json to loomster so behold preview ../loomster --emulator keeps surfacing its three tiers — has landed. loomster now carries:

{ "tiers": { "envVar": "LOOM_TIER", "values": ["light", "production", "production-ha"] } }

Both follow-ups it listed as non-blocking are resolved or tracked: #76 (multi-stack stacks[] picker) is closed, and #74 (non-AWS substrate parity) continues as its own track.