its-magic 0.1.2-55 → 0.1.2

package/template/.cursor/commands/research.md

@@ -15,6 +15,10 @@ description: "its-magic research: gather references and risks before architectur
   subagent/chat.
 
 ## Inputs
+
+- **Narrow-read (US-0053 / US-0096 Tranche A)**: Start at docs/engineering/phase-context.md
+  and the story section anchor in vision/architecture/decisions when a heading exists; forbid
+  full-file reads when a section heading exists.
 - `docs/product/vision.md`
 - `docs/product/backlog.md`
 - `docs/product/acceptance.md`

package/template/.cursor/commands/resume.md

@@ -23,6 +23,10 @@ At the end of `/resume`, append an isolation evidence entry to
 - `evidence_ref=docs/engineering/state.md` (resume resolution summary and next-phase recommendation)
 
 ## Inputs
+
+- **Narrow-read (US-0053 / US-0096 Tranche A)**: Start at docs/engineering/phase-context.md
+  and the story section anchor in vision/architecture/decisions when a heading exists; forbid
+  full-file reads when a section heading exists.
 - `docs/engineering/state.md`
 - `docs/engineering/decisions.md`
 - `sprints/S0001/summary.md`

package/template/.cursor/commands/security-review.md

@@ -14,6 +14,10 @@ description: "its-magic security-review: optional security and compliance review
   subagent/chat.
 
 ## Inputs
+
+- **Narrow-read (US-0053 / US-0096 Tranche A)**: Start at docs/engineering/phase-context.md
+  and the story section anchor in vision/architecture/decisions when a heading exists; forbid
+  full-file reads when a section heading exists.
 - `SECURITY_REVIEW` and `COMPLIANCE_PROFILES` from `.cursor/scratchpad.md`
 - `docs/engineering/architecture.md`
 - `docs/engineering/decisions.md`

package/template/.cursor/commands/sprint-plan.md

@@ -13,6 +13,10 @@ description: "its-magic sprint plan: create sprint and atomic tasks."
   subagent/chat.
 
 ## Inputs
+
+- **Narrow-read (US-0053 / US-0096 Tranche A)**: Start at docs/engineering/phase-context.md
+  and the story section anchor in vision/architecture/decisions when a heading exists; forbid
+  full-file reads when a section heading exists.
 - Architecture and decisions
 - Current backlog priorities
 - `.cursor/scratchpad.md` — read SPRINT_MAX_TASKS and SPRINT_AUTO_SPLIT

package/template/.cursor/commands/status-reconcile.md

@@ -15,6 +15,10 @@ description: "its-magic status-reconcile: deterministic status normalization and
 - After writing outputs, stop and recommend next phase.
 
 ## Inputs
+
+- **Narrow-read (US-0053 / US-0096 Tranche A)**: Start at docs/engineering/phase-context.md
+  and the story section anchor in vision/architecture/decisions when a heading exists; forbid
+  full-file reads when a section heading exists.
 - `docs/product/backlog.md` (canonical status source)
 - `docs/product/acceptance.md` (derived checklist surface)
 - `docs/engineering/state.md` (traceability + checkpoints)

package/template/.cursor/commands/verify-work.md

@@ -24,6 +24,10 @@ At the end of `/verify-work`, append an isolation evidence entry to
 - `evidence_ref=<primary output ref>` (recommended: `sprints/Sxxxx/uat.json` and `sprints/Sxxxx/uat.md`)
 
 ## Inputs
+
+- **Narrow-read (US-0053 / US-0096 Tranche A)**: Start at docs/engineering/phase-context.md
+  and the story section anchor in vision/architecture/decisions when a heading exists; forbid
+  full-file reads when a section heading exists.
 - `docs/product/acceptance.md`
 - `sprints/S0001/summary.md`
 

package/template/.cursor/dev-environment.json.example

@@ -0,0 +1,22 @@
+{
+  "schema_version": 1,
+  "detected_mode": "docker-host-local",
+  "operator_seeded": true,
+  "last_updated": "2026-06-14T00:00:00Z",
+  "compose_file": "docker-compose.yml",
+  "service": "app",
+  "target_id": "",
+  "connect": {
+    "endpoint": "http://localhost:3000",
+    "health_path": "/health",
+    "hostEnv": "DEV_HOST",
+    "portEnv": "DEV_PORT",
+    "protocolEnv": "DEV_PROTOCOL"
+  },
+  "rebuild_recipe": {
+    "default_tier": "B",
+    "restart_on_source_change": false
+  },
+  "env_refs": ["DEV_HOST", "DEV_PORT", "DEV_PROTOCOL"],
+  "evidence_refs": ["sprints/S0088/summary.md"]
+}

package/template/.cursor/scratchpad.local.example.md

@@ -169,17 +169,32 @@ AUTO_PUSH_BRANCH_ALLOWLIST=
 # - ARCH_HOT_MAX_STORY_SECTIONS: integer >= 20 (max # US-xxxx story sections retained)
 # - Manual-override precedence: explicit flag values in this file remain authoritative
 #   for that flag and override profile defaults.
+#
+# Delivery mode (US-0096 / DEC-0082)
+# - DELIVERY_MODE: standard|ultra_lean|mega_quick (default standard; unset = standard)
+# - LEAN_MEMORY_READ: 0|1 (default 1 when pack/active-context paths exist)
+# - LEAN_MEMORY_WRITE: 0|1 (default 1 when pack/active-context paths exist)
+# - LEAN_COLD_READ_MAX_SECTIONS: int >= 1 (default 4)
+# - LEAN_STATE_INDEX_ROWS: int >= 30 (default 80)
+# - AUTO_DELIVERY_ROUTING: scratchpad_only|backlog_then_scratchpad (default scratchpad_only)
+# Tranche A default hot caps (US-0096): 1000/650/3000 — explicit values override.
+DELIVERY_MODE=standard
+LEAN_MEMORY_READ=1
+LEAN_MEMORY_WRITE=1
+LEAN_COLD_READ_MAX_SECTIONS=4
+LEAN_STATE_INDEX_ROWS=80
+AUTO_DELIVERY_ROUTING=scratchpad_only
 EARLY_RESEARCH=1
 INTAKE_GUIDED_MODE=1
 INTAKE_SUBAGENT_FALLBACK=deny
 INTAKE_WORK_ITEM_KIND=story
 ID_NAMESPACE_BOOTSTRAP=0
 TOKEN_PROFILE=balanced
-STATE_HOT_MAX_LINES=1200
+STATE_HOT_MAX_LINES=1000
 STATE_HOT_MAX_CHECKPOINTS=80
-PO_TO_TL_HOT_MAX_LINES=800
+PO_TO_TL_HOT_MAX_LINES=650
 PO_TO_TL_HOT_MAX_SECTIONS=60
-ARCH_HOT_MAX_LINES=3500
+ARCH_HOT_MAX_LINES=3000
 ARCH_HOT_MAX_STORY_SECTIONS=120
 
 # Publish targets (US-0054)
@@ -238,6 +253,18 @@ DOC_DETAIL_LEVEL=balanced
 # - README_FEATURE_COVERAGE_ENFORCE: 0|1 (default 0 until backfill + --report green)
 README_FEATURE_COVERAGE_ENFORCE=1
 
+#
+# ## Project README coverage (US-0097 / DEC-0083)
+# Project-owned root README bootstrap + per-story catalog growth.
+# - PROJECT_README_ENFORCE: 0|1 (default 1 post-bootstrap)
+#   When 0, /release step 3g skips (migration/grandfathering only). When 1, blocking.
+#   Flip 0→1 only after validate_project_readme_coverage.py --report shows coverage_missing: [].
+# - FRAMEWORK_KIT_REPO: 0|1 (default 0)
+#   When 1 (its-magic dev kit repo only), skip execute 23a/23b and project validator root check.
+#   Consumer repos never set FRAMEWORK_KIT_REPO=1.
+PROJECT_README_ENFORCE=1
+FRAMEWORK_KIT_REPO=0
+
 #
 # ## Browser UAT self-test (US-0093 / DEC-0079)
 # Two-tier browser probe: stdlib lib classifies + agent owns Cursor browser MCP (BUG-0006).
@@ -259,6 +286,16 @@ UAT_PROCESS_HEALTH_POLL_INTERVAL_SECONDS=2
 DEV_SERVER_PORT=
 DEV_SERVER_COMMAND=
 
+#
+# ## Dev environment auto-launch (US-0098 / DEC-0084)
+# Execute-phase bounded rebuild/relaunch + Connect surfacing — distinct from US-0065 phase QA,
+# US-0086 test routing, and US-0067 release hints. Orthogonal to AUTO_REMOTE_AUTOMATION_PROFILE.
+# When off, execute step 24 skipped with zero overhead.
+# - DEV_AUTO_LAUNCH_PROFILE: off|deterministic_v1 (default off)
+# - DEV_ENVIRONMENT_CONFIG: repo-relative path (default .cursor/dev-environment.json)
+DEV_AUTO_LAUNCH_PROFILE=off
+DEV_ENVIRONMENT_CONFIG=.cursor/dev-environment.json
+
 #
 # ## Caveman mode (US-0089)
 # Response-side voice toggle. Default off. Composition is orthogonal to