Repository navigation
ROADMAP §4.6, §4.9, §4.10, §4.11: rendered plan views, host swap, context-window share, aladdin entry point - #15
Merged
Conversation
…an.md (ROADMAP §4.6) With "tasks" in a story's targets.json the plan is the execution source: `targets render` writes the three md files as deterministic views over it (the shapes gate-plan-shape, ids freeze and gate-stage2-complete already check) and `targets check` refuses a view that was hand-edited, so the md files cannot fork from the plan. A targets-only file keeps today's behaviour. Test: scripts/test/plan-render.test.py (5 checks). Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014j4wLin3oJTtnvjE9Lq2VV
… state (ROADMAP §4.9) `host swap --to H` hands the sprint over from the sprint dir (handoff.json / plan-ready.md), .aladdin/config.yaml and .agentic/logs only. A missing piece or a live worker worktree blocks (it would be orphaned); the target host's capability gaps are named; the resume rule lists tasks to re-gate. It writes .agentic/state/host-swap.json and emits sprint.context_handoff. SessionStart on the new host consumes the record, resumes with the same rule (also mid-sprint, without NEXT.md) and records the rotation. Test: scripts/test/host-swap.test.py (5 checks). Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014j4wLin3oJTtnvjE9Lq2VV
…P §4.10) Hosts do not report the model's context window, so the human states it (context.window in .aladdin/config.yaml, default 200000) and stats.md divides the context peak by it. Closes the last open §4.10 item. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014j4wLin3oJTtnvjE9Lq2VV
adeelahmad
changed the base branch from
claude/project-thread-vm6wyr
to
master
October 18, 2026 06:06
…ll (ROADMAP §4.11) `aladdin "<intent>"` records the Intent Contract (and the raw words beside it) and prints how to start the run on this host; `run` repeats the pending intent; `status` sweeps the sprint, applies the resume rule and shows token totals; `resume` shows what SessionStart loads; `report` shows stats.md; `target|context|refs|callers|callees|shadow|scope` are the semantic queries; every other aloop tool answers unchanged. `/aladdin` defers to `/aloop`. Installs link ~/.local/bin/aladdin and copy the skill. Drops the stray bin/aloop-init.orig left by the rename merge. Test: scripts/test/aladdin-cli.test.py (5 checks). Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014j4wLin3oJTtnvjE9Lq2VV
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014j4wLin3oJTtnvjE9Lq2VV
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Requested by Adeel · project thread
Before: the planner wrote tasks.md, validate.md and plan.md by hand beside targets.json, so the two could drift; a sprint belonged to the host it started on; stats.md showed the context peak but not how much of the window it was; the product had no entry point of its own beyond
/aloop.After: with
tasksin targets.json the semantic plan is the execution source:aloop targets renderwrites the three md files as deterministic views andtargets check(gate-stage2-complete) refuses a hand-edited one.aloop host swap --to codex|opencode|claudehands a sprint to another host from portable state only (sprint dir,.aladdin/config.yaml,.agentic/logs); a missing piece or a live worker worktree blocks, capability gaps are named, and SessionStart on the new host resumes under the same resume rule. stats.md adds the context-window share from the newAGENTIC_CONTEXT_WINDOWsetting (context.window).aladdin "<intent>"records the Intent Contract and prints how to start;aladdin status|resume|reportread the harness files; the semantic queries and every aloop tool answer under the new name; a/aladdinskill defers to/aloop; installs link and copy the new names.This closes the last open items of ROADMAP §4.6, §4.9 and §4.10 and starts §4.11 (README reorder and site remain).
How:
targetsgainsrender [--check]and the render diff insidecheck;hostgainsswap, writing.agentic/state/host-swap.jsonand emittingsprint.context_handoff, whichsession-startconsumes (also mid-sprint, without NEXT.md);_paths/_config/aloop-initlearnCONTEXT_WINDOW;bin/aladdinis a bash dispatcher over the existing tools; the straybin/aloop-init.origfrom the rename merge is removed.Evidence:
make test-hosts:plan-render.test.py5,host-swap.test.py5,aladdin-cli.test.py5;metrics.test.pygains the share rowmake test-hosts30 suites green locally,make lint(shellcheck, pyflakes, json) clean,claude plugin validate --strictpasses,check-tracking.py38 requirements ok🤖 Generated with Claude Code
https://claude.ai/code/session_014j4wLin3oJTtnvjE9Lq2VV