holistic 0.2.2 → 0.3.0

package/dist/core/docs.js

@@ -1,6 +1,13 @@
 import fs from "node:fs";
+import path from "node:path";
 import { renderCliFallbackNote } from './cli-fallback.js';
 import { readArchivedSessions } from './state.js';
+function renderSessionCloseBlock(hasMcp) {
+    if (hasMcp) {
+        return `## Before ending this session\n\nCall \`holistic_handoff\` with a summary of what you did and what should happen next. This keeps repo memory current for the next agent.\n`;
+    }
+    return `## Before ending this session\n\nRun:\n\`\`\`\nholistic handoff --summary "..." --next "..."\n\`\`\`\nThis keeps repo memory current for the next agent.\n`;
+}
 function renderList(items, emptyText) {
     if (items.length === 0) {
         return `- ${emptyText}`;
@@ -124,12 +131,12 @@ function renderKnownFixes(fixes) {
         }
         return entry;
     }).join("\n");
-    return `## Known Fixes — Do Not Regress
-
-⚠️  If you are about to edit a file listed here, STOP and read the fix entry first.
-
-${items}
-
+    return `## Known Fixes - Do Not Regress
+
+⚠️  If you are about to edit a file listed here, STOP and read the fix entry first.
+
+${items}
+
 `;
 }
 function renderHolisticMd(state) {
@@ -141,212 +148,212 @@ function renderHolisticMd(state) {
         .join("\n");
     const { fixes, other: otherRegressions } = parseKnownFixes(snapshot.regressions);
     const knownFixesBlock = renderKnownFixes(fixes);
-    return `# HOLISTIC
-
-<!-- ═══════════════════════════════════════════════════════════════════════
-     AGENT INSTRUCTIONS — READ THIS ENTIRE FILE BEFORE DOING ANYTHING ELSE
-     ═══════════════════════════════════════════════════════════════════════
-
-  1. Read this file top-to-bottom.
+    return `# HOLISTIC
+
+<!-- ═══════════════════════════════════════════════════════════════════════
+     AGENT INSTRUCTIONS - READ THIS ENTIRE FILE BEFORE DOING ANYTHING ELSE
+     ═══════════════════════════════════════════════════════════════════════
+
+  1. Read this file top-to-bottom.
   2. Read AGENTS.md for the setup steps specific to your agent.
   3. Summarise to the user: what was last worked on, what's planned next.
-  4. Ask: "What would you like to work on — continue recent work, or start something new?"
-  5. Run \`holistic resume --agent <your-agent-name>\` to open a session.
-  6. If \`holistic\` is not on PATH, use the repo-local helper under \`system/\` for this repo.
-
-  ⚠️  If you are about to edit a file listed under KNOWN FIXES, STOP and
-     read that fix entry carefully before proceeding.
-  ════════════════════════════════════════════════════════════════════════ -->
-
+  4. Ask: "What would you like to work on - continue recent work, or start something new?"
+  5. Open the session with the repo-local Holistic helper for this repo.
+
+  ⚠️  If you are about to edit a file listed under KNOWN FIXES, STOP and
+     read that fix entry carefully before proceeding.
+  ════════════════════════════════════════════════════════════════════════ -->
+
 ## Start Here
 
 This repo uses Holistic for cross-agent handoffs. The source of truth is the repo itself: handoff docs, history, and regression memory should be committed and synced so any device can continue. Read this file first, then review the long-term history docs and zero-touch architecture note, then use the adapter doc for your app. The Holistic daemon is optional and only improves passive capture on devices where it is installed.
 
 ${resumeFallbackNote}
-
-## Product North Star
-
-Open repo, start working, Holistic quietly keeps continuity alive.
-
-That is the intended end state for this project. Prefer changes that reduce ceremony, keep continuity durable, and make Holistic fade further into the background of normal work.
-
-${knownFixesBlock}## Current Objective
-
-**${snapshot.title}**
-
-${snapshot.goal}
-
-## Latest Work Status
-
-${snapshot.status}
-
-## What Was Tried
-
-${renderList(snapshot.tried, "Nothing recorded yet.")}
-
-## What To Try Next
-
-${renderList(snapshot.next, "Ask the user what they'd like to work on.")}
-
-## Active Plan
-
-${renderList(snapshot.plan, "None yet — will be set once work begins.")}
-
-## Overall Impact So Far
-
-${renderList(snapshot.impacts, "Nothing recorded yet.")}
-
-## Regression Watch
-
-${renderList(otherRegressions, "Review the regression watch document before changing related behavior.")}
-
-## Key Assumptions
-
-${renderList(snapshot.assumptions, "None recorded.")}
-
-## Blockers
-
-${renderList(snapshot.blockers, "None.")}
-
-## Changed Files In Current Session
-
-${renderList(snapshot.changedFiles, "No repo changes detected for the active session.")}
-
-## Pending Work Queue
-
-${pendingPreview.length === 0 ? "- None." : pendingPreview.map((item) => `- ${item.title}: ${item.recommendedNextStep}`).join("\n")}
-
-## Long-Term Memory
-
-- Project history: [${state.docIndex.historyDoc}](${state.docIndex.historyDoc})
-- Regression watch: [${state.docIndex.regressionDoc}](${state.docIndex.regressionDoc})
-- Zero-touch architecture: [${state.docIndex.zeroTouchDoc}](${state.docIndex.zeroTouchDoc})
-- Portable sync model: handoffs are intended to be committed and synced so any device with repo access can continue.
-
-## Supporting Documents
-
-- State file: [${state.docIndex.stateFile}](${state.docIndex.stateFile})
-- Current plan: [${state.docIndex.currentPlanDoc}](${state.docIndex.currentPlanDoc})
-- Session protocol: [${state.docIndex.protocolDoc}](${state.docIndex.protocolDoc})
-- Session archive: [${state.docIndex.sessionsDir}](${state.docIndex.sessionsDir})
-- Adapter docs:
-${adapterLinks}
-
-## Historical Memory
-
-- Last updated: ${state.updatedAt}
-- Last handoff: ${state.lastHandoff ? `${state.lastHandoff.summary}` : "None yet."}
-- Pending sessions remembered: ${state.pendingWork.length}
+
+## Product North Star
+
+Open repo, start working, Holistic quietly keeps continuity alive.
+
+That is the intended end state for this project. Prefer changes that reduce ceremony, keep continuity durable, and make Holistic fade further into the background of normal work.
+
+${knownFixesBlock}## Current Objective
+
+**${snapshot.title}**
+
+${snapshot.goal}
+
+## Latest Work Status
+
+${snapshot.status}
+
+## What Was Tried
+
+${renderList(snapshot.tried, "Nothing recorded yet.")}
+
+## What To Try Next
+
+${renderList(snapshot.next, "Ask the user what they'd like to work on.")}
+
+## Active Plan
+
+${renderList(snapshot.plan, "None yet - will be set once work begins.")}
+
+## Overall Impact So Far
+
+${renderList(snapshot.impacts, "Nothing recorded yet.")}
+
+## Regression Watch
+
+${renderList(otherRegressions, "Review the regression watch document before changing related behavior.")}
+
+## Key Assumptions
+
+${renderList(snapshot.assumptions, "None recorded.")}
+
+## Blockers
+
+${renderList(snapshot.blockers, "None.")}
+
+## Changed Files In Current Session
+
+${renderList(snapshot.changedFiles, "No repo changes detected for the active session.")}
+
+## Pending Work Queue
+
+${pendingPreview.length === 0 ? "- None." : pendingPreview.map((item) => `- ${item.title}: ${item.recommendedNextStep}`).join("\n")}
+
+## Long-Term Memory
+
+- Project history: [${state.docIndex.historyDoc}](${state.docIndex.historyDoc})
+- Regression watch: [${state.docIndex.regressionDoc}](${state.docIndex.regressionDoc})
+- Zero-touch architecture: [${state.docIndex.zeroTouchDoc}](${state.docIndex.zeroTouchDoc})
+- Portable sync model: handoffs are intended to be committed and synced so any device with repo access can continue.
+
+## Supporting Documents
+
+- State file: [${state.docIndex.stateFile}](${state.docIndex.stateFile})
+- Current plan: [${state.docIndex.currentPlanDoc}](${state.docIndex.currentPlanDoc})
+- Session protocol: [${state.docIndex.protocolDoc}](${state.docIndex.protocolDoc})
+- Session archive: [${state.docIndex.sessionsDir}](${state.docIndex.sessionsDir})
+- Adapter docs:
+${adapterLinks}
+
+## Historical Memory
+
+- Last updated: ${state.updatedAt}
+- Last handoff: ${state.lastHandoff ? `${state.lastHandoff.summary}` : "None yet."}
+- Pending sessions remembered: ${state.pendingWork.length}
 `;
 }
 function renderAgentsMd(state) {
     const resumeFallbackNote = renderCliFallbackNote(state.docIndex.contextDir, "resume --agent <your-agent-name>");
     const checkpointFallbackNote = renderCliFallbackNote(state.docIndex.contextDir, "checkpoint --reason \"<why>\"");
+    const checkpointFixNote = renderCliFallbackNote(state.docIndex.contextDir, "checkpoint --fixed \"<bug>\" --fix-files \"<file>\" --fix-risk \"<what would reintroduce it>\"");
     const handoffFallbackNote = renderCliFallbackNote(state.docIndex.contextDir, "handoff");
+    const startNewNote = renderCliFallbackNote(state.docIndex.contextDir, "start-new --goal \"<goal>\"");
+    const watchNote = renderCliFallbackNote(state.docIndex.contextDir, "watch");
     return `# AGENTS
-
-<!-- ═══════════════════════════════════════════════════════════════════
-     AGENT AUTO-START INSTRUCTIONS
-     ═══════════════════════════════════════════════════════════════════
-
-  YOU ARE READING THIS FILE AUTOMATICALLY AT SESSION START. GOOD.
-  Now do the following BEFORE responding to the user or doing any work:
-
-  1. Read HOLISTIC.md in full.
+
+<!-- ═══════════════════════════════════════════════════════════════════
+     AGENT AUTO-START INSTRUCTIONS
+     ═══════════════════════════════════════════════════════════════════
+
+  YOU ARE READING THIS FILE AUTOMATICALLY AT SESSION START. GOOD.
+  Now do the following BEFORE responding to the user or doing any work:
+
+  1. Read HOLISTIC.md in full.
   2. Summarise to the user: what was last worked on, what's planned next,
      and flag any KNOWN FIXES they should be aware of.
-  3. Ask: "What would you like to work on — continue recent work, or start something new?"
-  4. Run: holistic resume --agent <your-agent-name>
-  5. If that command is unavailable, use the repo-local Holistic helper for this repo.
-
-  DO NOT skip step 1. HOLISTIC.md is the source of truth.
-  ══════════════════════════════════════════════════════════════════ -->
-
-## Holistic Protocol
-
-### Product North Star
-
-Open repo, start working, Holistic quietly keeps continuity alive.
-
-Agents should treat that as the ultimate UX target. Prefer decisions that reduce manual ceremony while making checkpoint, resume, handoff, and regression-awareness more automatic and more reliable.
-
-Every agent working in this repo should:
-
-1. Read [HOLISTIC.md](./HOLISTIC.md) first.
-2. Review [Project History](./.holistic/context/project-history.md), [Regression Watch](./.holistic/context/regression-watch.md), and [Zero-Touch Architecture](./.holistic/context/zero-touch.md) before changing behavior that may already have been fixed.
-3. Read the app-specific adapter in \`${state.docIndex.contextDir}/adapters/\`.
+  3. Ask: "What would you like to work on - continue recent work, or start something new?"
+  4. Open the session with the repo-local Holistic helper for this repo.
+
+  DO NOT skip step 1. HOLISTIC.md is the source of truth.
+  ══════════════════════════════════════════════════════════════════ -->
+
+## Holistic Protocol
+
+### Product North Star
+
+Open repo, start working, Holistic quietly keeps continuity alive.
+
+Agents should treat that as the ultimate UX target. Prefer decisions that reduce manual ceremony while making checkpoint, resume, handoff, and regression-awareness more automatic and more reliable.
+
+Every agent working in this repo should:
+
+1. Read [HOLISTIC.md](./HOLISTIC.md) first.
+2. Review [Project History](./.holistic/context/project-history.md), [Regression Watch](./.holistic/context/regression-watch.md), and [Zero-Touch Architecture](./.holistic/context/zero-touch.md) before changing behavior that may already have been fixed.
+3. Read the app-specific adapter in \`${state.docIndex.contextDir}/adapters/\`.
 4. If the Holistic daemon is installed, assume passive capture is already running in the background.
-5. Run \`holistic resume --agent <codex|claude|antigravity|gemini|copilot|cursor|goose|gsd>\` only when you need an explicit recap or recovery flow.
+5. Use the repo-local Holistic helper for explicit recap or recovery flows in this repo.
 6. Recap the current state for the user and ask whether to continue, tweak the plan, or start something new.
 7. Record a checkpoint when focus changes, before likely context compaction, and before handoff.
 
 ${resumeFallbackNote}
-
-## Handoff Commands
-
-- \`holistic checkpoint --reason "<why>"\`
-- \`holistic checkpoint --fixed "<bug>" --fix-files "<file>" --fix-risk "<what would reintroduce it>"\`
-- \`holistic set-phase --phase "<id>" --name "<name>" --goal "<goal>"\`
-- \`holistic complete-phase --phase "<id>" --next-phase "<id>" --next-name "<name>" --next-goal "<goal>"\`
-- \`holistic handoff\`
-- \`holistic start-new --goal "<goal>"\`
-- \`holistic watch\`
-
-Fallbacks when PATH is missing:
+
+## Handoff Commands
+
 - ${checkpointFallbackNote.slice(3)}
+- ${checkpointFixNote.slice(3)}
+- \`holistic set-phase --phase "<id>" --name "<name>" --goal "<goal>"\`
+- \`holistic complete-phase --phase "<id>" --next-phase "<id>" --next-name "<name>" --next-goal "<goal>"\`
 - ${handoffFallbackNote.slice(3)}
-
-## Adding a New Agent Adapter
-
-To add instructions for a new agent, create a file at:
-
-\`${state.docIndex.contextDir}/adapters/<agent-name>.md\`
-
-Copy any existing adapter as a template and customise the agent name and startup steps.
-Do not edit Holistic source files to register agents — adapters are data, not code.
+- ${startNewNote.slice(3)}
+- ${watchNote.slice(3)}
+
+## Before Ending a Session
+
+${renderSessionCloseBlock(false)}
+## Adding a New Agent Adapter
+
+To add instructions for a new agent, create a file at:
+
+\`${state.docIndex.contextDir}/adapters/<agent-name>.md\`
+
+Copy any existing adapter as a template and customise the agent name and startup steps.
+Do not edit Holistic source files to register agents - adapters are data, not code.
 `;
 }
 function renderContextReadme(state) {
-    return `# Holistic Context
-
-This folder holds repo-visible memory that any agent can reuse.
-
-- [Current Plan](./current-plan.md)
-- [Session Protocol](./session-protocol.md)
-- [Project History](./project-history.md)
-- [Regression Watch](./regression-watch.md)
-- [Zero-Touch Architecture](./zero-touch.md)
-- [Codex Adapter](./adapters/codex.md)
-- [Claude/Cowork Adapter](./adapters/claude-cowork.md)
-- [Antigravity Adapter](./adapters/antigravity.md)
-
-Project: ${state.projectName}
-Updated: ${state.updatedAt}
+    return `# Holistic Context
+
+This folder holds repo-visible memory that any agent can reuse.
+
+- [Current Plan](./current-plan.md)
+- [Session Protocol](./session-protocol.md)
+- [Project History](./project-history.md)
+- [Regression Watch](./regression-watch.md)
+- [Zero-Touch Architecture](./zero-touch.md)
+- [Codex Adapter](./adapters/codex.md)
+- [Claude/Cowork Adapter](./adapters/claude-cowork.md)
+- [Antigravity Adapter](./adapters/antigravity.md)
+
+Project: ${state.projectName}
+Updated: ${state.updatedAt}
 `;
 }
 function renderCurrentPlan(state) {
     const snapshot = currentSnapshot(state);
-    return `# Current Plan
-
-## Goal
-
-${snapshot.goal}
-
-## Latest Status
-
-${snapshot.status}
-
-## Planned Next Steps
-
-${renderList(snapshot.plan.length > 0 ? snapshot.plan : snapshot.next, "No plan captured yet.")}
-
-## Project Impact
-
-${renderList(snapshot.impacts, "No impact notes captured yet.")}
-
-## References
-
-${renderList(snapshot.refs, "No linked references yet.")}
+    return `# Current Plan
+
+## Goal
+
+${snapshot.goal}
+
+## Latest Status
+
+${snapshot.status}
+
+## Planned Next Steps
+
+${renderList(snapshot.plan.length > 0 ? snapshot.plan : snapshot.next, "No plan captured yet.")}
+
+## Project Impact
+
+${renderList(snapshot.impacts, "No impact notes captured yet.")}
+
+## References
+
+${renderList(snapshot.refs, "No linked references yet.")}
 `;
 }
 function renderProtocol(state) {
@@ -354,40 +361,40 @@ function renderProtocol(state) {
     const checkpointFallbackNote = renderCliFallbackNote(state.docIndex.contextDir, "checkpoint --reason \"<what changed>\"");
     const handoffFallbackNote = renderCliFallbackNote(state.docIndex.contextDir, "handoff");
     return `# Session Protocol
-
-## Product North Star
-
-Open repo, start working, Holistic quietly keeps continuity alive.
-
-The protocol below is the current operating model, not the final ideal. When improving Holistic, prefer changes that make more of this protocol happen automatically without weakening durable continuity.
-
-## Startup
-
-1. Read \`HOLISTIC.md\`.
+
+## Product North Star
+
+Open repo, start working, Holistic quietly keeps continuity alive.
+
+The protocol below is the current operating model, not the final ideal. When improving Holistic, prefer changes that make more of this protocol happen automatically without weakening durable continuity.
+
+## Startup
+
+1. Read \`HOLISTIC.md\`.
 2. Review \`project-history.md\`, \`regression-watch.md\`, and \`zero-touch.md\` for durable project memory and automation expectations.
 3. If the Holistic daemon is installed, let it capture repo activity in the background.
-4. Run \`holistic resume --agent <app>\` only when you need an explicit recap or recovery flow.
+4. Use the repo-local Holistic helper for explicit recap or recovery flows in this repo.
 5. Recap the work state to the user.
 6. Ask whether to continue as planned, tweak the plan, or start something new.
 
 ${resumeFallbackNote}
-
-## During The Session
-
-Run \`holistic checkpoint\`:
-
-- when the task focus changes
-- before likely context compaction
-- after meaningful progress
-- when you fix something another agent might accidentally re-break later
-
-Use \`holistic watch\` if you want foreground background checkpoints while working manually.
+
+## During The Session
+
+Use the repo-local Holistic helper for checkpoints in this repo:
+
+- when the task focus changes
+- before likely context compaction
+- after meaningful progress
+- when you fix something another agent might accidentally re-break later
+
+Use the repo-local Holistic helper with \`watch\` if you want foreground background checkpoints while working manually.
 
 ${checkpointFallbackNote}
-
-## Handoff
-
-1. Run \`holistic handoff\`.
+
+## Handoff
+
+1. Use the repo-local Holistic helper to run \`handoff\`.
 2. Confirm or edit the drafted summary.
 3. Make sure the next step, impact, and regression risks are accurate.
 4. Let Holistic write the docs and create the handoff commit.\n5. Holistic sync helpers should push the current branch and mirror portable state to the dedicated portable state ref.\n6. If you continue on another device, pull or restore the latest portable state before starting work.
@@ -395,49 +402,50 @@ ${checkpointFallbackNote}
 ${handoffFallbackNote}
 `;
 }
-function renderAdapter(state, appName, commandName) {
+function renderAdapter(state, appName, commandName, hasMcp) {
     const resumeFallbackNote = renderCliFallbackNote(state.docIndex.contextDir, `resume --agent ${commandName}`);
     const checkpointFallbackNote = renderCliFallbackNote(state.docIndex.contextDir, "checkpoint --reason \"<what changed>\"");
     const handoffFallbackNote = renderCliFallbackNote(state.docIndex.contextDir, "handoff");
     return `# ${appName} Adapter
-
-## Product North Star
-
-Open repo, start working, Holistic quietly keeps continuity alive.
-
-Use this adapter to move toward that outcome: less manual setup, less re-briefing, and more continuity preserved by default.
-
-## Startup Contract
-
-1. Read \`HOLISTIC.md\`.
+
+## Product North Star
+
+Open repo, start working, Holistic quietly keeps continuity alive.
+
+Use this adapter to move toward that outcome: less manual setup, less re-briefing, and more continuity preserved by default.
+
+## Startup Contract
+
+1. Read \`HOLISTIC.md\`.
 2. Review \`project-history.md\`, \`regression-watch.md\`, and \`zero-touch.md\` for durable memory before editing related code.
 3. If the Holistic daemon is installed, treat passive session capture as already active.
-4. Run \`holistic resume --agent ${commandName}\` when you need an explicit recap or recovery flow.
+4. Use the repo-local Holistic helper when you need an explicit recap or recovery flow.
 5. Recap the current state for the user in the first 30 seconds.
 6. Ask: continue as planned, tweak the plan, or start something new.
 
 ${resumeFallbackNote}
-
-## Checkpoint Contract
-
-Run \`holistic checkpoint\` when:
-
-- the task focus changes
-- you are about to compact or clear context
-- you finish a meaningful chunk of work
-- you fix or alter behavior that could regress later
-
+
+## Checkpoint Contract
+
+Use the repo-local Holistic helper for checkpoints in this repo when:
+
+- the task focus changes
+- you are about to compact or clear context
+- you finish a meaningful chunk of work
+- you fix or alter behavior that could regress later
+
 Include impact notes and regression risks when they matter.
 
 ${checkpointFallbackNote}
-
-## Handoff Contract
-
-- Preferred: map your session-end workflow to \`holistic handoff\`
-- Fallback: ask the user to run \`holistic handoff\` before leaving the session
+
+## Handoff Contract
+
+- Preferred: map your session-end workflow to the repo-local Holistic helper with \`handoff\`
+- Fallback: ask the user to run the repo-local Holistic helper with \`handoff\` before leaving the session
 
 ${handoffFallbackNote}
-`;
+
+${renderSessionCloseBlock(hasMcp)}`;
 }
 function renderProjectHistory(paths, state) {
     const sessions = state.activeSession ? [state.activeSession, ...readArchivedSessions(paths)] : readArchivedSessions(paths);
@@ -510,79 +518,120 @@ function renderRegressionWatch(paths, state) {
     return `# Regression Watch\n\nUse this before changing existing behavior. It is the short list of fixes and outcomes that future agents should preserve.\n\n${body}\n`;
 }
 function renderZeroTouchDoc(state) {
-    return `# Zero-Touch Architecture
-
-Holistic cannot force every app or agent to execute startup logic just because a repo exists. Zero-touch behavior therefore has two layers.
-
-## Product North Star
-
-Open repo, start working, Holistic quietly keeps continuity alive.
-
-Zero-touch architecture exists to close the gap between the current protocol and that goal.
-
-## Repo Layer
-
-- \`HOLISTIC.md\`, \`AGENTS.md\`, project history, and regression watch stay inside the repo so any agent that reads repo instructions can recover context.
-- This layer travels with git and works cross-agent as long as the tool respects repo-visible instructions.
-- The portable expectation is that handoff docs get committed and synced so another device can continue later.
-
-## Machine Layer
-
-- A background Holistic daemon can watch the repo and create passive checkpoints without you manually starting a session.
-- Generated restore scripts can pull the dedicated Holistic portable state ref into the working tree when it is safe to do so.
-- This is the only realistic way to get close to seamless cross-tool capture when apps do not expose a startup hook.
-- It requires a one-time machine install or service registration outside the repo.
-
-## Hard Limit
-
-- If a tool ignores repo instructions and there is no daemon or app integration, the repo alone cannot make that tool participate.
-- Holistic can preserve memory and offer recovery, but it cannot force arbitrary apps to cooperate from inside git-tracked files.
-
-## Current Recommendation
-
-- Keep using repo-visible memory as the portable source of truth.
-- Treat the dedicated Holistic portable state ref as the clean cross-device distribution channel for that memory.
-- Add the Holistic daemon as the passive capture layer on devices where you want unattended local capture.
-- Add app-specific integrations when a tool exposes startup hooks or slash-command automation.
-- Holistic should recognize workflow systems, not become one.
-- Prefer lightweight workflow context references over baking phases, slices, or other planning structures into the core product.
-- Prefer workflow-disappearance improvements over adding more visible user ceremony.
-
-Project: ${state.projectName}
-Updated: ${state.updatedAt}
+    return `# Zero-Touch Architecture
+
+Holistic cannot force every app or agent to execute startup logic just because a repo exists. Zero-touch behavior therefore has two layers.
+
+## Product North Star
+
+Open repo, start working, Holistic quietly keeps continuity alive.
+
+Zero-touch architecture exists to close the gap between the current protocol and that goal.
+
+## Repo Layer
+
+- \`HOLISTIC.md\`, \`AGENTS.md\`, project history, and regression watch stay inside the repo so any agent that reads repo instructions can recover context.
+- This layer travels with git and works cross-agent as long as the tool respects repo-visible instructions.
+- The portable expectation is that handoff docs get committed and synced so another device can continue later.
+
+## Machine Layer
+
+- A background Holistic daemon can watch the repo and create passive checkpoints without you manually starting a session.
+- Generated restore scripts can pull the dedicated Holistic portable state ref into the working tree when it is safe to do so.
+- This is the only realistic way to get close to seamless cross-tool capture when apps do not expose a startup hook.
+- It requires a one-time machine install or service registration outside the repo.
+
+## Hard Limit
+
+- If a tool ignores repo instructions and there is no daemon or app integration, the repo alone cannot make that tool participate.
+- Holistic can preserve memory and offer recovery, but it cannot force arbitrary apps to cooperate from inside git-tracked files.
+
+## Current Recommendation
+
+- Keep using repo-visible memory as the portable source of truth.
+- Treat the dedicated Holistic portable state ref as the clean cross-device distribution channel for that memory.
+- Add the Holistic daemon as the passive capture layer on devices where you want unattended local capture.
+- Add app-specific integrations when a tool exposes startup hooks or slash-command automation.
+- Holistic should recognize workflow systems, not become one.
+- Prefer lightweight workflow context references over baking phases, slices, or other planning structures into the core product.
+- Prefer workflow-disappearance improvements over adding more visible user ceremony.
+
+Project: ${state.projectName}
+Updated: ${state.updatedAt}
 `;
 }
-function renderRootAgentDoc(agentName, commandName) {
-    return `## Holistic — cross-agent session tracking
+function renderIdeCursorRulesContent(state) {
+    const snapshot = currentSnapshot(state);
+    const { fixes, other: otherRegressions } = parseKnownFixes(snapshot.regressions);
+    const resumeCmd = renderCliFallbackNote(state.docIndex.contextDir, "resume --agent cursor");
+    const handoffCmd = renderCliFallbackNote(state.docIndex.contextDir, "handoff");
+    const fixLines = fixes.length > 0
+        ? `## Do Not Regress - Known Fixes\n\n${fixes.map((f) => `- ${f}`).join("\n")}\n`
+        : "";
+    const regressionLines = otherRegressions.length > 0
+        ? `## Regression Watch\n\n${otherRegressions.map((r) => `- ${r}`).join("\n")}\n`
+        : "";
+    return `# Holistic - ${state.projectName}
+
+## Session Start
+
+At the start of every session, before doing anything else:
+1. Read \`HOLISTIC.md\` in full.
+2. Read \`AGENTS.md\`.
+3. Summarise to the user: what was last worked on, what's planned next, and any known fixes to protect.
+4. Ask: "Continue as planned, tweak the plan, or do something different?"
+5. ${resumeCmd}
+
+## Current Objective
+
+${snapshot.goal}
+
+## Latest Status
+
+${snapshot.status}
+
+${fixLines}${regressionLines}${renderSessionCloseBlock(false)}`;
+}
+function renderCursorRules(state) {
+    return renderIdeCursorRulesContent(state);
+}
+function renderWindsurfRules(state) {
+    return renderIdeCursorRulesContent(state);
+}
+function renderCopilotInstructions(state) {
+    return renderIdeCursorRulesContent(state);
+}
+function renderRootAgentDoc(agentName, commandName, hasMcp) {
+    return `## Holistic - cross-agent session tracking
 
 **At the start of every session, before doing anything else:**
 1. Read \`HOLISTIC.md\` in full.
-2. Read \`AGENTS.md\` — find the section for your agent and follow its setup steps.
+2. Read \`AGENTS.md\` - find the section for your agent and follow its setup steps.
 3. Summarise to the user: what was last worked on, what's planned next, and any known fixes to protect.
 4. Ask: "Continue as planned, tweak the plan, or do something different?"
-5. Run \`holistic resume --agent ${commandName}\` to register the session.
-6. If \`holistic\` is not on PATH, use \`./.holistic/system/holistic resume --agent ${commandName}\` on macOS/Linux or \`.\\.holistic\\system\\holistic.cmd resume --agent ${commandName}\` on Windows.
-
-**After significant work or on any git commit (hook fires automatically):**
-- Run \`holistic checkpoint --reason '<what you just did>'\`
-- To record a fix that must not regress: \`holistic checkpoint --fixed '<bug>' --fix-files '<file>' --fix-risk '<what reintroduces it>'\`
-
-**At the end of every session:**
-- Run \`holistic handoff\` — this opens a dialog to capture the summary.
-- Then commit: \`git add HOLISTIC.md AGENTS.md CLAUDE.md GEMINI.md HISTORY.md .holistic/ && git commit -m 'docs(holistic): handoff'\`
-
-**Never touch files listed in the KNOWN FIXES section of HOLISTIC.md without reading that section first.**
-`;
+5. Use \`./.holistic/system/holistic resume --agent ${commandName}\` on macOS/Linux or \`.\\.holistic\\system\\holistic.cmd resume --agent ${commandName}\` on Windows to register the session.
+
+**After significant work or on any git commit (hook fires automatically):**
+- Run \`holistic checkpoint --reason '<what you just did>'\`
+- To record a fix that must not regress: \`holistic checkpoint --fixed '<bug>' --fix-files '<file>' --fix-risk '<what reintroduces it>'\`
+
+**At the end of every session:**
+- Run \`holistic handoff\` - this opens a dialog to capture the summary.
+- Then commit: \`git add HOLISTIC.md AGENTS.md CLAUDE.md GEMINI.md HISTORY.md .holistic/ && git commit -m 'docs(holistic): handoff'\`
+
+**Never touch files listed in the KNOWN FIXES section of HOLISTIC.md without reading that section first.**
+
+${renderSessionCloseBlock(hasMcp)}`;
 }
 function renderRootHistoryMd(paths, state) {
     const sessions = state.activeSession
         ? [state.activeSession, ...readArchivedSessions(paths)]
         : readArchivedSessions(paths);
-    const header = `# History — ${state.projectName}
-
-_Append-only log of every Holistic session. Newest entries at the bottom._
-
----
+    const header = `# History - ${state.projectName}
+
+_Append-only log of every Holistic session. Newest entries at the bottom._
+
+---
 `;
     if (sessions.length === 0) {
         return header + "_No sessions recorded yet._\n";
@@ -620,17 +669,27 @@ export function writeDerivedDocs(paths, state) {
     fs.writeFileSync(paths.regressionDoc, renderRegressionWatch(paths, state), "utf8");
     fs.writeFileSync(paths.zeroTouchDoc, renderZeroTouchDoc(state), "utf8");
     fs.writeFileSync(`${paths.contextDir}/README.md`, renderContextReadme(state), "utf8");
-    fs.writeFileSync(`${paths.adaptersDir}/codex.md`, renderAdapter(state, "Codex", "codex"), "utf8");
-    fs.writeFileSync(`${paths.adaptersDir}/claude-cowork.md`, renderAdapter(state, "Claude/Cowork", "claude"), "utf8");
-    fs.writeFileSync(`${paths.adaptersDir}/antigravity.md`, renderAdapter(state, "Antigravity", "antigravity"), "utf8");
+    fs.writeFileSync(`${paths.adaptersDir}/codex.md`, renderAdapter(state, "Codex", "codex", false), "utf8");
+    fs.writeFileSync(`${paths.adaptersDir}/claude-cowork.md`, renderAdapter(state, "Claude/Cowork", "claude", true), "utf8");
+    fs.writeFileSync(`${paths.adaptersDir}/antigravity.md`, renderAdapter(state, "Antigravity", "antigravity", false), "utf8");
     if (paths.rootClaudeDoc) {
-        fs.writeFileSync(paths.rootClaudeDoc, renderRootAgentDoc("Claude/Cowork", "claude"), "utf8");
+        fs.writeFileSync(paths.rootClaudeDoc, renderRootAgentDoc("Claude/Cowork", "claude", true), "utf8");
     }
     if (paths.rootGeminiDoc) {
-        fs.writeFileSync(paths.rootGeminiDoc, renderRootAgentDoc("Antigravity/Gemini", "antigravity"), "utf8");
+        fs.writeFileSync(paths.rootGeminiDoc, renderRootAgentDoc("Antigravity/Gemini", "antigravity", false), "utf8");
     }
     if (paths.rootHistoryDoc) {
         fs.writeFileSync(paths.rootHistoryDoc, renderRootHistoryMd(paths, state), "utf8");
     }
+    if (paths.rootCursorRulesDoc) {
+        fs.writeFileSync(paths.rootCursorRulesDoc, renderCursorRules(state), "utf8");
+    }
+    if (paths.rootWindsurfRulesDoc) {
+        fs.writeFileSync(paths.rootWindsurfRulesDoc, renderWindsurfRules(state), "utf8");
+    }
+    if (paths.rootCopilotInstructionsDoc) {
+        fs.mkdirSync(path.dirname(paths.rootCopilotInstructionsDoc), { recursive: true });
+        fs.writeFileSync(paths.rootCopilotInstructionsDoc, renderCopilotInstructions(state), "utf8");
+    }
 }
 //# sourceMappingURL=docs.js.map