@intutic/sync-daemon 2.1.0 → 2.3.0

package/dist/sessionReporter.js

@@ -6,10 +6,11 @@
  * capture and the Jira/Linear/GitHub task-context cascade) had no production
  * caller: sessions only ever existed as synthetic `ssp_` rows minted
  * server-side. The daemon knows everything the route wants — workspace root,
- * harness, git branch and commit — so it reports them once per harness per
- * daemon run when the harness is first detected.
+ * harness, git repository, branch and commit — so it reports them when the
+ * harness is first detected, and again whenever the repository, branch or
+ * HEAD commit changes.
  *
- * WHICH row it reports them onto (TD-231, Wave 5.6): when a local proxy is
+ * WHICH row it reports them onto (Wave 5.6): when a local proxy is
  * reachable, the caller passes that process's `proxyInstanceId` and the
  * control plane puts the context on the proxy's OWN row — the
  * `ssp_<ws>_<harness>_<instance>` session it derives for that process's
@@ -26,17 +27,20 @@
  * (PATCH /api/v1/sessions/:id/end).
  *
  * Dedupe lives here (module state keyed workspace+harness+instance), so
- * callers — `startSyncLoop`'s iteration as well as the CLI's inline connect
- * loop — can call `startHarnessSession` every iteration and only the first
- * one POSTs. Git context is captured once per key, not on a branch switch.
- * Everything is best-effort: a dead control plane costs a warning, never the
- * sync loop.
+ * callers (`reportHarnessAgents`, every `intutic connect` cycle) can call
+ * `startHarnessSession` every iteration. Git is read on every call and the
+ * session is POSTed again only when it changed: the control plane copies the
+ * session's git context onto each trace as it records it, which is what makes
+ * cost per branch and per commit possible, so a stale commit would file a
+ * call under the wrong one. A re-POST updates the same row. Everything is
+ * best-effort: a dead control plane costs a warning, never the sync loop.
  *
  * @module
  */
 import { execFile } from 'node:child_process';
 import { promisify } from 'node:util';
 import { newIso } from '@intutic/id';
+import { normalizeGitRemote } from '@intutic/shared-types';
 const execFileP = promisify(execFile);
 /**
  * sessionIds this daemon run opened AND owns the lifecycle of — the `ses_`
@@ -48,8 +52,12 @@ const openSessions = new Map();
  * `${workspaceId}:${harness}:${proxyInstanceId}`. Dedupe only — never ended.
  */
 const registeredProxyRows = new Map();
-/** Keys with a POST in flight or already attempted (success or not) — one try per run. */
-const attempted = new Set();
+/**
+ * The git context last POSTed (or attempted, success or not) per key. One try
+ * per key and git state per run: a failing control plane is not retried every
+ * cycle, but a branch switch or a new commit is reported.
+ */
+const attempted = new Map();
 /** Best-effort git context from the workspace root. */
 export async function readGitInfo(workspaceRoot) {
     const git = async (...args) => {
@@ -62,28 +70,31 @@ export async function readGitInfo(workspaceRoot) {
             return undefined;
         }
     };
-    const [branchName, commitHash, commitMessage] = await Promise.all([
+    const [remote, branchName, commitHash, commitMessage] = await Promise.all([
+        git('remote', 'get-url', 'origin'),
         git('rev-parse', '--abbrev-ref', 'HEAD'),
         git('rev-parse', 'HEAD'),
         git('log', '-1', '--format=%s'),
     ]);
-    return { branchName, commitHash, commitMessage };
+    // Normalised here, before it is held anywhere: a remote can embed a token.
+    const repoUrl = remote ? (normalizeGitRemote(remote) ?? undefined) : undefined;
+    return { repoUrl, branchName, commitHash, commitMessage };
 }
 /**
- * Report a harness session once per run — onto the local proxy's own row when
- * `proxyInstanceId` is given (see the module doc), else as a new `ses_` row.
- * Returns the sessionId when one is known (new or previously created).
+ * Report a harness session — onto the local proxy's own row when
+ * `proxyInstanceId` is given (see the module doc), else as a `ses_` row — and
+ * report it again when its git context changes. Returns the sessionId when one
+ * is known (new or previously created).
  */
 export async function startHarnessSession(opts) {
     const key = `${opts.workspaceId}:${opts.harnessType}:${opts.proxyInstanceId ?? ''}`;
     const existing = opts.proxyInstanceId ? registeredProxyRows.get(key) : openSessions.get(key);
-    if (existing)
-        return existing;
-    if (attempted.has(key))
-        return null;
-    attempted.add(key);
+    const git = await readGitInfo(opts.workspaceRoot);
+    const gitState = JSON.stringify([git.repoUrl, git.branchName, git.commitHash]);
+    if (attempted.get(key) === gitState)
+        return existing ?? null;
+    attempted.set(key, gitState);
     try {
-        const git = await readGitInfo(opts.workspaceRoot);
         const res = await fetch(`${opts.controlPlaneUrl}/api/v1/sessions`, {
             method: 'POST',
             headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${opts.apiKey}` },
@@ -92,6 +103,8 @@ export async function startHarnessSession(opts) {
                 harnessType: opts.harnessType,
                 ...(opts.agentRole ? { agentRole: opts.agentRole } : {}),
                 ...(opts.proxyInstanceId ? { proxyInstanceId: opts.proxyInstanceId } : {}),
+                // A `ses_` row this run already opened is updated, not opened again.
+                ...(existing && !opts.proxyInstanceId ? { sessionId: existing } : {}),
                 ...git,
                 reportedAt: newIso(),
             }),
@@ -99,7 +112,7 @@ export async function startHarnessSession(opts) {
         });
         if (!res.ok) {
             console.warn(`[sync-daemon] startHarnessSession failed for ${opts.harnessType}: ${res.status}`);
-            return null;
+            return existing ?? null;
         }
         const body = (await res.json());
         if (body.sessionId) {
@@ -107,11 +120,11 @@ export async function startHarnessSession(opts) {
             (opts.proxyInstanceId ? registeredProxyRows : openSessions).set(key, body.sessionId);
             return body.sessionId;
         }
-        return null;
+        return existing ?? null;
     }
     catch (err) {
         console.warn(`[sync-daemon] startHarnessSession error for ${opts.harnessType}:`, err instanceof Error ? err.message : err);
-        return null;
+        return existing ?? null;
     }
 }
 /**

package/dist/sessionReporter.js.map

@@ -1 +1 @@
-{"version":3,"file":"sessionReporter.js","sourceRoot":"","sources":["../src/sessionReporter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sessionReporter.js","sourceRoot":"","sources":["../src/sessionReporter.ts"],"names":[],"mappings":"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"}

package/dist/skillWriter.d.ts

@@ -5,17 +5,35 @@
  * written only when absent (write-if-missing), never overwrite user edits,
  * and are deliberately not tracked by the drift watcher / IntegrityStore.
  *
- * The skill content is embedded as a constant because the daemon runs
- * outside the monorepo. The canonical source is
- * `.agents/skills/intutic-rule-author/SKILL.md` in the open-core repo; a
- * test asserts the two stay identical.
+ * Two skills ship: the rule-author skill, which teaches an agent to extend
+ * governance, and the Kitkat skill, which teaches it to operate under it —
+ * what each refusal code means, what a hold is and who approves it. Every
+ * connected agent meets refusals, so Kitkat is written alongside the rule
+ * author rather than left as a manual download.
+ *
+ * Each is written as a file Intutic owns (disconnect/originals.ts):
+ * `intutic disconnect` deletes it again, unless it was edited since, and
+ * never touches a copy that was already there.
+ *
+ * The skill content is embedded as constants because the daemon runs outside
+ * the monorepo. The canonical sources are `.agents/skills/<name>/SKILL.md` in
+ * the open-core repo; a test asserts each pair stays identical.
  *
  * @module
  */
 /** Workspace-relative path the rule-author skill is written to. */
 export declare const RULE_AUTHOR_SKILL_PATH: string;
 /** Embedded copy of .agents/skills/intutic-rule-author/SKILL.md (canonical). */
-export declare const RULE_AUTHOR_SKILL = "---\nname: intutic-rule-author\ndescription: Convert natural-language business rules into compiled WASM governance policies enforced by the local Intutic proxy \u2014 author, compile, dry-run, and install rules without a control plane.\n---\n\n# \uD83D\uDCDC Rule Author \u2014 Business Rules as Enforced WASM Policies\n\nUse this skill whenever the user states a rule that AI agent traffic must obey \u2014 \"block any agent call that touches the prod database\", \"kill requests once the session budget drops below $1\", \"never allow shell tool calls containing rm -rf\". You convert the rule into an AssemblyScript policy, compile it to WebAssembly, dry-run it against mock contexts, and install it into the local Intutic proxy. The proxy hot-loads it within ~5 seconds and enforces it on every intercepted LLM request.\n\n**The other way you get here is `/fix`.** That proxy command scores the workspace's governance posture and, when it finds no custom policy, recommends: *\"Add a WASM rule under `~/.intutic/wasm` to codify a custom guardrail.\"* When that recommendation is the prompt, the rule to author is the gap `/fix` found \u2014 ask the user which specific behaviour they want blocked rather than writing a generic rule, then run `/fix` again after installing to confirm the posture score moved. If it did not, the rule is not loading: check `intutic policy list-local` and the sandbox constraints in \u00A72, since a rule that violates them is silently disabled.\n\n## 1. The contract your rule sees\n\nThe proxy calls `evaluate(offset, len)` with a JSON-serialized `RequestContext`:\n\n```jsonc\n{\n  \"session_id\": \"sess_x\", \"workspace_id\": \"ws_x\", \"virtual_key_prefix\": \"vk_x\",\n  \"model\": \"claude-3-5-sonnet\",\n  \"tools\": [{ \"name\": \"bash\", \"description\": \"run shell commands\" }],\n  \"tool_calls\": [{ \"id\": \"t1\", \"name\": \"bash\", \"arguments\": {} }],\n  \"estimated_input_tokens\": 1200,\n  \"budget_remaining_usd\": 4.25,\n  \"risk_tier\": \"Low\",\n  \"dlp_findings\": [{ \"category\": \"secret\", \"pattern_name\": \"aws_access_key\", \"action\": \"redact\", \"offset\": 0, \"length\": 20 }],\n  \"tool_sequence\": [\"read_file\", \"bash\"]\n}\n```\n\n`risk_tier` is one of `Low | Medium | High | Critical`. Return an `i32` verdict: `0` = ALLOW, `1` = BLOCK, `3` = REASK (refuse this attempt, tell the agent why, let it retry). `2` is deprecated \u2014 the guest never receives the request body, so redaction was never expressible; the proxy maps it to a block. Prefer `3` over `1` for any finding that is a pattern match, because pattern matches produce false positives.\n\n## 2. Author\n\nStart from the `@intutic/wasm-sdk` template (`packages/wasm-sdk/` in the open-core repo). Add one function per business rule and call it from `runRules()` in `assembly/index.ts`.\n\nSandbox constraints \u2014 violating them silently disables the rule (the proxy **fails open**):\n\n- 5 ms wall-clock budget, 1,000,000 fuel, 16 MB memory.\n- Keep logic simple: no unbounded loops over `arguments`, no recursion, no I/O (none exists in the sandbox).\n- Host imports are limited to `env.log_info`, `env.trace`, `env.abort` and `env.read_referenced_file` (reads the bytes of a file the host already resolved before the sandbox existed \u2014 not a filesystem import, and it cannot be used to browse). A rule importing anything else cannot link, so it is refused at `intutic policy install` and refused again when the proxy loads it.\n- **`Math.random()` is unavailable.** AssemblyScript compiles it to an `env.seed` import the proxy does not provide. This list previously named `env.seed`, and a rule using randomness installed clean and then failed to link on every request \u2014 enforcing nothing, silently. Beyond the missing import, a verdict that samples is not a verdict: the same request would get different answers, and the audit trail would not explain either.\n\n## 3. Compile\n\n```bash\nintutic policy compile --src assembly/index.ts --out build/rule.wasm\n```\n\nRequires AssemblyScript in the project: `pnpm add -D assemblyscript assemblyscript-json`.\n\n## 4. Dry-run \u2014 required before install\n\nAuthor BOTH mock contexts and verify both outcomes before installing:\n\n```bash\nintutic policy test --wasm build/rule.wasm --mock should-block.json\nintutic policy test --wasm build/rule.wasm --mock should-allow.json\n```\n\nThe first must report BLOCK, the second ALLOW. A rule that blocks everything is as broken as one that blocks nothing.\n\n## 5. Install\n\n```bash\nintutic policy install --wasm build/rule.wasm --name block-prod-db --priority 50\nintutic policy list-local\n```\n\nRules install to `~/.intutic/wasm/` as `NN_name.wasm` (lower `NN` runs first; default 100). The proxy picks up changes within ~5 s on the next request \u2014 no restart needed.\n\n## 6. Guardrails\n\n- **Never embed secrets** (API keys, tokens, passwords) in rule sources or mock contexts \u2014 `intutic skill audit` flags them.\n- **Local rules cannot weaken central rules.** Verdicts merge most-restrictive-wins: a KILL from any rule \u2014 local or centrally synced \u2014 ends the request. \"Allow-override\" rules are no-ops by design; do not author them.\n- Keep rule sources (`assembly/*.ts`, mock JSON files) in version control alongside the workspace.\n";
+export declare const RULE_AUTHOR_SKILL = "---\nname: intutic-rule-author\ndescription: Convert natural-language business rules into compiled WASM governance policies enforced by the local Intutic proxy \u2014 author, compile, dry-run, and install rules without a control plane.\n---\n\n# \uD83D\uDCDC Rule Author \u2014 Business Rules as Enforced WASM Policies\n\nUse this skill whenever the user states a rule that AI agent traffic must obey \u2014 \"block any agent call that touches the prod database\", \"kill requests once the session budget drops below $1\", \"never allow shell tool calls containing rm -rf\". You convert the rule into an AssemblyScript policy, compile it to WebAssembly, dry-run it against mock contexts, and install it into the local Intutic proxy. The proxy hot-loads it within ~5 seconds and enforces it on every intercepted LLM request.\n\n**The other way you get here is `/fix`.** That proxy command scores the workspace's governance posture and, when it finds no custom policy, recommends: *\"Add a WASM rule under `~/.intutic/wasm` to codify a custom guardrail.\"* When that recommendation is the prompt, the rule to author is the gap `/fix` found \u2014 ask the user which specific behaviour they want blocked rather than writing a generic rule, then run `/fix` again after installing to confirm the posture score moved. If it did not, the rule is not loading: check `intutic policy list-local` and the sandbox constraints in \u00A72, since a rule that violates them is silently disabled.\n\n## 1. The contract your rule sees\n\nThe proxy calls `evaluate(offset, len)` with a JSON-serialized `RequestContext`:\n\n```jsonc\n{\n  \"session_id\": \"sess_x\", \"workspace_id\": \"ws_x\", \"virtual_key_prefix\": \"vk_x\",\n  \"model\": \"claude-3-5-sonnet\",\n  \"tools\": [{ \"name\": \"bash\", \"description\": \"run shell commands\" }],\n  \"tool_calls\": [{ \"id\": \"t1\", \"name\": \"bash\", \"arguments\": {} }],\n  \"estimated_input_tokens\": 1200,\n  \"budget_remaining_usd\": 4.25,\n  \"risk_tier\": \"Low\",\n  \"dlp_findings\": [{ \"category\": \"secret\", \"pattern_name\": \"aws_access_key\", \"action\": \"redact\", \"offset\": 0, \"length\": 20 }],\n  \"tool_sequence\": [\"read_file\", \"bash\"]\n}\n```\n\n`risk_tier` is one of `Low | Medium | High | Critical`. Return an `i32` verdict: `0` = ALLOW, `1` = BLOCK, `3` = REASK (refuse this attempt, tell the agent why, let it retry). `2` is deprecated \u2014 the guest never receives the request body, so redaction was never expressible; the proxy maps it to a block. Prefer `3` over `1` for any finding that is a pattern match, because pattern matches produce false positives.\n\n## 2. Author\n\nStart from the `@intutic/wasm-sdk` template (`packages/wasm-sdk/` in the open-core repo). Add one function per business rule and call it from `runRules()` in `assembly/index.ts`.\n\nSandbox constraints \u2014 a rule that breaks one reaches no verdict, and every call it could not judge is refused with `GOVERNANCE_UNAVAILABLE`, whatever the proxy's fail setting:\n\n- 1,000,000 fuel (instructions), the limit to write against; a 1 s wall-clock backstop; 16 MB memory.\n- Keep logic simple: no unbounded loops over `arguments`, no recursion, no I/O (none exists in the sandbox).\n- Host imports are limited to `env.log_info`, `env.trace`, `env.abort` and `env.read_referenced_file` (reads the bytes of a file the host already resolved before the sandbox existed \u2014 not a filesystem import, and it cannot be used to browse). A rule importing anything else cannot link, so it is refused at `intutic policy install` and refused again when the proxy loads it.\n- **`Math.random()` is unavailable.** AssemblyScript compiles it to an `env.seed` import the proxy does not provide. This list previously named `env.seed`, and a rule using randomness installed clean and then failed to link on every request \u2014 enforcing nothing, silently. Beyond the missing import, a verdict that samples is not a verdict: the same request would get different answers, and the audit trail would not explain either.\n\n## 3. Compile\n\n```bash\nintutic policy compile --src assembly/index.ts --out build/rule.wasm\n```\n\nRequires AssemblyScript in the project: `pnpm add -D assemblyscript assemblyscript-json`.\n\n## 4. Dry-run \u2014 required before install\n\nAuthor BOTH mock contexts and verify both outcomes before installing:\n\n```bash\nintutic policy test --wasm build/rule.wasm --mock should-block.json\nintutic policy test --wasm build/rule.wasm --mock should-allow.json\n```\n\nThe first must report BLOCK, the second ALLOW. A rule that blocks everything is as broken as one that blocks nothing.\n\n## 5. Install\n\n```bash\nintutic policy install --wasm build/rule.wasm --name block-prod-db --priority 50\nintutic policy list-local\n```\n\nRules install to `~/.intutic/wasm/` as `NN_name.wasm` (lower `NN` runs first; default 100). The proxy picks up changes within ~5 s on the next request \u2014 no restart needed.\n\n## 6. Guardrails\n\n- **Never embed secrets** (API keys, tokens, passwords) in rule sources or mock contexts \u2014 `intutic skill audit` flags them.\n- **Local rules cannot weaken central rules.** Verdicts merge most-restrictive-wins: a KILL from any rule \u2014 local or centrally synced \u2014 ends the request. \"Allow-override\" rules are no-ops by design; do not author them.\n- Keep rule sources (`assembly/*.ts`, mock JSON files) in version control alongside the workspace.\n";
+/** Workspace-relative path the Kitkat skill is written to. */
+export declare const KITKAT_SKILL_PATH: string;
+/** Embedded copy of .agents/skills/intutic-governance-kitkat/SKILL.md (canonical). */
+export declare const KITKAT_SKILL = "---\nname: intutic-governance-kitkat\ndescription: Guide and execute Intutic governed developer workflows, ticket cost attributions, pre-flight token predictions, and safety policy interceptions using the Kitkat persona.\n---\n\n# \uD83D\uDC31 Kitkat \u2014 Intutic Agentic Governance Skill\n\nHello! I am **Kitkat**, your friendly agentic control plane assistant for the Intutic Governance Engine. I ensure that your AI agentic workflows are safe, structured, FinOps-optimized, and compliant with both global enterprise policies (Notion/Confluence) and local rules.\n\n---\n\n## \uD83D\uDEE0\uFE0F CLI Reference Catalog\n\nUse the `intutic` CLI commands to manage the daemon, inspect execution traces, or manage governed task loops in your workspace:\n\n### 1. Connection & Session Setup\n- **Authenticate:** `intutic login [--control-plane-url <url>]` (authenticates with your Intutic control plane).\n- **Initialize Workspace:** `intutic init` (detects the developer harnesses in the workspace, like Claude Code or Cursor, and records them for sync).\n- **Start Connection:** `intutic connect` (boots the local interceptor proxy, writes each recorded harness's rules and hooks, keeps them in sync with the control plane, and writes this skill and the rule-author skill into `.agents/skills/` when they are missing).\n- **Stop Governing:** `intutic disconnect [--harness <id>] [--dry-run] [--keep-login]` (undoes `connect` on this machine: restores every harness config it changed, removes its hooks, services and the skills it wrote, and logs out). Run it only when the user asks; `--dry-run` shows what would change.\n- **Offline Spend Sync:** The sync daemon automatically reconciles offline query consumption logs (`traces-*.jsonl`) and local budgets back to the control plane on reconnect.\n\n### 2. Traces & Auditing\n- **Check Budget:** `intutic budget` (displays overall monthly/daily spend limits, local spend caps, and active task loops).\n- **List Sessions:** `intutic traces list`\n- **Inspect Session Trace:** `intutic traces inspect <trace_id>`\n- **Push SOP Rules:** `intutic sops push <name>` (promotes local SOP rules to central repository).\n\n### 3. Governed Task Loops\n- **Start Task Loop:** `intutic loop start --name <name> [--budget <USD>] [--sops <indices_or_names>] [--auto-judge]`\n- **Execute Wrapped Agent:** `intutic loop exec --name <name> [--budget <USD>] [--sops <indices_or_names>] [--auto-judge] -- <command>`\n- **Complete/Kill Loop:** `intutic loop complete <loopRunId>` / `intutic loop kill <loopRunId>`\n- **List Active Loops:** `intutic loop list`\n\n---\n\n## \uD83D\uDD0C Interception & Command Prepends\n\nWhen interacting with LLM providers through the local proxy, prepend requests with `@intutic` (or `/intutic`) to control the active governance session:\n\n### 1. Cost & Task Attribution\n- **Initialize Picker:** `@intutic initialize`\n  - *Description:* Pulls open tickets from linked task providers (Jira, Linear, GitHub Issues) and recommends ticket candidates for the session.\n- **Lock Session & Scope Rules:** `@intutic start [<ticket_id>] [--sops=<names_or_indices>] [--auto-judge]`\n  - *Description:* Attributes token costs to a ticket (optional) and scopes active local SOP directories for governance.\n  - *Examples:*\n    * `@intutic start 1 --sops=3 --auto-judge`\n    * `@intutic start --sops=security-rules --auto-judge`\n\n### 2. FinOps & Token Projections\n- **Predict Costs:** `@intutic predict <prompt>`\n  - *Description:* Estimates input/output tokens and cost breakdown before submitting the request to the upstream model.\n- **Optimize Context:** `@intutic recommend`\n  - *Description:* Provides recommendations on prompt adjustments and context reduction strategies to minimize token waste.\n\n### 3. Policy Compliance & E2E Judging\n- **Verify Prompt:** `@intutic verify <prompt>` (or `@intutic check <prompt>`)\n  - *Description:* Audits the prompt pre-flight against active SOPs and guidelines, returning pass/fail verdicts and listing any violations before submitting requests to the LLM.\n- **Review Prompt:** `@intutic review <prompt>`\n  - *Description:* Runs a deep heuristic prompt quality evaluation to grade clarity, specificity, and actionability.\n- **Judge Response:** `@intutic judge <prompt>`\n  - *Description:* Submits the prompt to the upstream LLM and evaluates the response stream in parallel using LLM-as-a-judge compliance checkers.\n  - *Note:* If no prompt is provided (e.g. `@intutic judge`), returns usage instructions.\n- **Inspect Status:** `@intutic status` (displays active session stats, average compliance, and spent budget).\n- **Inspect Budget:** `@intutic budget` (displays daily monitored limits and workspace progress).\n\n### 4. Posture & Prompt Enhancement\n- **Enhance & Diagnose:** `/fix <prompt>` (aliases: `@fix`, `/intutic-fix`, `@intutic fix`)\n  - *Description:* Rewrites the prompt and scores the workspace's governance posture against OWASP categories from what the proxy can see locally \u2014 DLP settings, WASM rules, the SOPs on disk for the caller's role, skills and MCP servers. Returns the enhanced prompt plus concrete recommendations for whatever is missing.\n  - *Note:* Blocking by default; it can be configured to pass the enhanced prompt through to the model instead. The recommendations are the handoff points into the rest of the toolchain \u2014 \"add a WASM rule\" is the `intutic-rule-author` skill's job, \"write a role SOP\" and \"enable DLP\" are handled here.\n- **Draw Guardrails:** `/draw` (aliases: `@draw`, `/intutic-draw`, `@intutic draw`)\n  - *Description:* Renders a Mermaid diagram plus text summary of the agent's trajectory and the guardrails currently around it. Always blocking \u2014 a visualization has nothing to forward upstream.\n\n---\n\n## \uD83D\uDEA6 When a Call Is Refused or Held\n\nIntutic names every refusal with a code: an SDK raises it (`ClawdeBlockedError.code`, `IntuticGateRefusal.code`), the MCP proxy puts it in `error.data.code`, a hook gate that answers in JSON (Cline, Grok Build, Antigravity) puts it in `code` beside `ruleId`, and the proxy names a withheld answer in its `x-intutic-refusal` header. A refusal you read as text, starting `[Intutic]` or `[Intutic Governance]`, is the same refusal: the call it names did not run (unless it says the result was withheld). Find the code below and act on it.\n\n### Held: tell the user, then wait\nA hold rule wants a person to see this call before it runs. Codes: `HELD` (with a hold id, `hold_\u2026`), a hook gate's `[Intutic Governance] HELD:` message, `LOOP_RUN_PENDING_REVIEW` (the loop run is paused for review), and the proxy's `policy_held` (a Rego or WASM rule held the request; the error names the hold id). `SERVER_HELD` is the MCP registry's version: the server changed its tools in a risky way and waits for an owner or admin on the MCP Servers page.\n- Tell the user what was held and quote the hold id.\n- Only an **Owner, Admin or Engineering Manager** can decide it: `intutic decision approve <holdId>` or `intutic decision reject <holdId>`, or the Slack card. A developer cannot approve their own hold.\n- Do not retry while it is pending. After approval, the identical call (same tool, same arguments) passes only if the workspace's review-hold bypass (`reviewHoldBypassEnabled`) is on, and only for a short window (10 minutes by default); otherwise approval records the decision and a retry is held again. The `intutic_hold_status` MCP tool says which.\n- A hold with no hold id could not be recorded, so there is nothing to approve: tell the user.\n\n### Revise: change the approach\n`policy_reask` (proxy) and `REASK` (MCP proxy) refuse this attempt with a reason. Do something different; repeating it becomes a block (`policy_denied`, `REASK_EXHAUSTED`).\n\n### Blocked: do not retry the same call\nContinue without it, or tell the user what would have to change and who can change it.\n- **Policy:** `policy_denied`, `TOOL_DENIED`, `SOP_RULE`, `SNAPSHOT`, `HOOK_GATE`, `ANOMALY`, `WASM_RULE`, `REASK_EXHAUSTED`, `LOOP_RUN_TERMINATED`, `model_not_allowed`.\n- **Protected by the hook gate:** `BUILT_IN_RULE`: a governance bypass, a write to Intutic's own config or a skill directory, or a secret in written content. Do not look for another route to the same change; tell the user.\n- **Identity:** `SSO_GROUP`: the user's SSO groups do not clear this tool (rule `sso_group.high_risk.<tool>` or `sso_group.require_obo.<tool>`). An admin grants the group; you cannot work around it.\n- **Data:** `dlp_policy_violation` and `DLP` (a secret, destructive command or PII value in the input: remove it), `INJECTION` (the input carries a prompt-injection pattern), `SQL_GUARD` (destructive SQL against a database not on the SQL allowlist: use an allowlisted database, named explicitly on the command line).\n- **MCP servers:** `SERVER_BLOCKED`, `SERVER_NOT_APPROVED`, `TOOL_DISABLED`, `SERVER_NOT_ALLOWED`, `TOOL_NOT_ALLOWED`, `TOOL_DEFINITIONS_CHANGED`. An owner or admin decides on the MCP Servers page; the `intutic_mcp_registry_status` MCP tool shows what the registry says.\n- **Spend:** `BUDGET_EXCEEDED`, `OVERAGE_HARD_CAP_EXCEEDED`, `COST_GATE_EXCEEDED` (a smaller request may pass). An MCP `BUDGET_EXCEEDED` lasts until its `resetAt`; `intutic_mcp_budget_remaining` shows what is left.\n- **Images:** `E_UNPINNED_LATEST`, `E_UNPINNED_TAG`, `E_UNKNOWN_REGISTRY`, `E_UNKNOWN_IMAGE`, `E_DIGEST_MISMATCH`, `E_MANIFEST_UNPARSEABLE`: deploy an image pinned to a digest the image allowlist approves.\n- **Gate setup:** `WORKFLOW_SANDBOX`, `NO_GATE`: the gate is wired wrongly in the agent's code; fix the code, not the call. `UNREADABLE_CALL`: the hook could not read the tool call from its harness, which is a setup fault to report, not something to retry.\n- **Custom rule could not decide:** `GOVERNANCE_UNAVAILABLE` whose reason names a custom rule (`Custom rule <id> reached no verdict (<cause>)`, rule id `wasm:<id>`; cause `deadline`, `budget`, `error`, `result` or `quarantined`). The rule cannot decide this input, so the same call is refused again however often it is retried. Do not retry it; tell the user, who can fix or remove the rule.\n- **Size:** `COMMAND_TOO_LARGE`: the command is over 256 KiB, or the tool's arguments over 1 MiB, more than any gate evaluates. Split the work: smaller commands, or a file written in parts. A hook gate that could not finish deciding in time says `GATE_DEADLINE` in its reason; the call did not run, and the same call will be refused again, so tell the user.\n\n### Not checked: retry once, later\n`GOVERNANCE_UNAVAILABLE` (unless it names a custom rule: see above), `REGISTRY_UNAVAILABLE`, `BUDGET_UNAVAILABLE`, `TOFU_UNAVAILABLE`, `RESPONSE_UNPARSEABLE`, `GATE_CRASHED` (the hook gate failed while deciding), `POLICY_SNAPSHOT_UNVERIFIED` (the policy snapshot on this machine failed its integrity check, so no MCP call runs until the sync daemon restores it), and `HOOK_GATE` when its reason says the control plane was unreachable: governance could not check the call, so it did not run. One later retry is fine; if it fails again, tell the user.\n\n### Ran, but the result was withheld\n`RESULT_WITHHELD_DLP`, `RESULT_WITHHELD_INJECTION` (MCP proxy) and `OUTPUT_DLP` (proxy): the tool or model ran, and its output was not delivered. Do not run it again blindly, since it may already have had its effect; tell the user.\n\n---\n\n## \uD83D\uDEE1\uFE0F Policy & Hook Verification\n\n1. **Pre-Tool Interception Hooks:**\n   Harness configurations (e.g. `.claude/settings.json`, `.cursor/hooks.json`) are automatically updated by `intutic connect`. They register execution hooks that block unauthorized tools or unsafe commands before execution.\n2. **Local Guidelines & Scoping:**\n   Define local, developer-specific rules inside subdirectories of the `.intutic/sops/` directory (e.g. `.intutic/sops/my-rules/rules.md`). Initialize them using `@intutic initialize` and select active local SOPs using `@intutic start <ticket> --sops=<indices_or_names>`. These rules are enforced locally in the developer console to protect developer privacy, while global/corporate rules log incidents back to the control plane.\n3. **Offline Sync & Promotion:**\n   When offline, prompt telemetry is stored locally in sharded files `~/.intutic/logs/traces-YYYY-MM-DD.jsonl` and budgets are enforced against sharded daily files `~/.intutic/logs/local-spend-YYYY-MM-DD.jsonl`. The sync daemon uploads them automatically on connect via `/api/v1/traces/sync-back` and cleans up the local files. Rules can be promoted workspace-wide via `intutic sops push <name>`.\n";
+/** Every skill connect writes, by workspace-relative path. */
+export declare const BUNDLED_SKILLS: ReadonlyArray<{
+    path: string;
+    content: string;
+}>;
 /**
  * Write bundled skills into the workspace, skipping any that already exist.
  * Returns the paths written (empty when everything was already present).

package/dist/skillWriter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skillWriter.d.ts","sourceRoot":"","sources":["../src/skillWriter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,mEAAmE;AACnE,eAAO,MAAM,sBAAsB,QAKlC,CAAA;AAED,gFAAgF;AAChF,eAAO,MAAM,iBAAiB,0sKA2E7B,CAAA;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAejF"}
+{"version":3,"file":"skillWriter.d.ts","sourceRoot":"","sources":["../src/skillWriter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAMH,mEAAmE;AACnE,eAAO,MAAM,sBAAsB,QAKlC,CAAA;AAED,gFAAgF;AAChF,eAAO,MAAM,iBAAiB,40KA2E7B,CAAA;AAED,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,QAA+E,CAAA;AAE7G,sFAAsF;AACtF,eAAO,MAAM,YAAY,w2YAsHxB,CAAA;AAED,8DAA8D;AAC9D,eAAO,MAAM,cAAc,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAG3E,CAAA;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBjF"}

package/dist/skillWriter.js

@@ -5,15 +5,25 @@
  * written only when absent (write-if-missing), never overwrite user edits,
  * and are deliberately not tracked by the drift watcher / IntegrityStore.
  *
- * The skill content is embedded as a constant because the daemon runs
- * outside the monorepo. The canonical source is
- * `.agents/skills/intutic-rule-author/SKILL.md` in the open-core repo; a
- * test asserts the two stay identical.
+ * Two skills ship: the rule-author skill, which teaches an agent to extend
+ * governance, and the Kitkat skill, which teaches it to operate under it —
+ * what each refusal code means, what a hold is and who approves it. Every
+ * connected agent meets refusals, so Kitkat is written alongside the rule
+ * author rather than left as a manual download.
+ *
+ * Each is written as a file Intutic owns (disconnect/originals.ts):
+ * `intutic disconnect` deletes it again, unless it was edited since, and
+ * never touches a copy that was already there.
+ *
+ * The skill content is embedded as constants because the daemon runs outside
+ * the monorepo. The canonical sources are `.agents/skills/<name>/SKILL.md` in
+ * the open-core repo; a test asserts each pair stays identical.
  *
  * @module
  */
 import * as node_fs from 'node:fs/promises';
 import * as node_path from 'node:path';
+import { keepOriginal, noteWritten } from './disconnect/originals.js';
 /** Workspace-relative path the rule-author skill is written to. */
 export const RULE_AUTHOR_SKILL_PATH = node_path.join('.agents', 'skills', 'intutic-rule-author', 'SKILL.md');
 /** Embedded copy of .agents/skills/intutic-rule-author/SKILL.md (canonical). */
@@ -52,9 +62,9 @@ The proxy calls \`evaluate(offset, len)\` with a JSON-serialized \`RequestContex
 
 Start from the \`@intutic/wasm-sdk\` template (\`packages/wasm-sdk/\` in the open-core repo). Add one function per business rule and call it from \`runRules()\` in \`assembly/index.ts\`.
 
-Sandbox constraints — violating them silently disables the rule (the proxy **fails open**):
+Sandbox constraints — a rule that breaks one reaches no verdict, and every call it could not judge is refused with \`GOVERNANCE_UNAVAILABLE\`, whatever the proxy's fail setting:
 
-- 5 ms wall-clock budget, 1,000,000 fuel, 16 MB memory.
+- 1,000,000 fuel (instructions), the limit to write against; a 1 s wall-clock backstop; 16 MB memory.
 - Keep logic simple: no unbounded loops over \`arguments\`, no recursion, no I/O (none exists in the sandbox).
 - Host imports are limited to \`env.log_info\`, \`env.trace\`, \`env.abort\` and \`env.read_referenced_file\` (reads the bytes of a file the host already resolved before the sandbox existed — not a filesystem import, and it cannot be used to browse). A rule importing anything else cannot link, so it is refused at \`intutic policy install\` and refused again when the proxy loads it.
 - **\`Math.random()\` is unavailable.** AssemblyScript compiles it to an \`env.seed\` import the proxy does not provide. This list previously named \`env.seed\`, and a rule using randomness installed clean and then failed to link on every request — enforcing nothing, silently. Beyond the missing import, a verdict that samples is not a verdict: the same request would get different answers, and the audit trail would not explain either.
@@ -93,23 +103,156 @@ Rules install to \`~/.intutic/wasm/\` as \`NN_name.wasm\` (lower \`NN\` runs fir
 - **Local rules cannot weaken central rules.** Verdicts merge most-restrictive-wins: a KILL from any rule — local or centrally synced — ends the request. "Allow-override" rules are no-ops by design; do not author them.
 - Keep rule sources (\`assembly/*.ts\`, mock JSON files) in version control alongside the workspace.
 `;
+/** Workspace-relative path the Kitkat skill is written to. */
+export const KITKAT_SKILL_PATH = node_path.join('.agents', 'skills', 'intutic-governance-kitkat', 'SKILL.md');
+/** Embedded copy of .agents/skills/intutic-governance-kitkat/SKILL.md (canonical). */
+export const KITKAT_SKILL = `---
+name: intutic-governance-kitkat
+description: Guide and execute Intutic governed developer workflows, ticket cost attributions, pre-flight token predictions, and safety policy interceptions using the Kitkat persona.
+---
+
+# 🐱 Kitkat — Intutic Agentic Governance Skill
+
+Hello! I am **Kitkat**, your friendly agentic control plane assistant for the Intutic Governance Engine. I ensure that your AI agentic workflows are safe, structured, FinOps-optimized, and compliant with both global enterprise policies (Notion/Confluence) and local rules.
+
+---
+
+## 🛠️ CLI Reference Catalog
+
+Use the \`intutic\` CLI commands to manage the daemon, inspect execution traces, or manage governed task loops in your workspace:
+
+### 1. Connection & Session Setup
+- **Authenticate:** \`intutic login [--control-plane-url <url>]\` (authenticates with your Intutic control plane).
+- **Initialize Workspace:** \`intutic init\` (detects the developer harnesses in the workspace, like Claude Code or Cursor, and records them for sync).
+- **Start Connection:** \`intutic connect\` (boots the local interceptor proxy, writes each recorded harness's rules and hooks, keeps them in sync with the control plane, and writes this skill and the rule-author skill into \`.agents/skills/\` when they are missing).
+- **Stop Governing:** \`intutic disconnect [--harness <id>] [--dry-run] [--keep-login]\` (undoes \`connect\` on this machine: restores every harness config it changed, removes its hooks, services and the skills it wrote, and logs out). Run it only when the user asks; \`--dry-run\` shows what would change.
+- **Offline Spend Sync:** The sync daemon automatically reconciles offline query consumption logs (\`traces-*.jsonl\`) and local budgets back to the control plane on reconnect.
+
+### 2. Traces & Auditing
+- **Check Budget:** \`intutic budget\` (displays overall monthly/daily spend limits, local spend caps, and active task loops).
+- **List Sessions:** \`intutic traces list\`
+- **Inspect Session Trace:** \`intutic traces inspect <trace_id>\`
+- **Push SOP Rules:** \`intutic sops push <name>\` (promotes local SOP rules to central repository).
+
+### 3. Governed Task Loops
+- **Start Task Loop:** \`intutic loop start --name <name> [--budget <USD>] [--sops <indices_or_names>] [--auto-judge]\`
+- **Execute Wrapped Agent:** \`intutic loop exec --name <name> [--budget <USD>] [--sops <indices_or_names>] [--auto-judge] -- <command>\`
+- **Complete/Kill Loop:** \`intutic loop complete <loopRunId>\` / \`intutic loop kill <loopRunId>\`
+- **List Active Loops:** \`intutic loop list\`
+
+---
+
+## 🔌 Interception & Command Prepends
+
+When interacting with LLM providers through the local proxy, prepend requests with \`@intutic\` (or \`/intutic\`) to control the active governance session:
+
+### 1. Cost & Task Attribution
+- **Initialize Picker:** \`@intutic initialize\`
+  - *Description:* Pulls open tickets from linked task providers (Jira, Linear, GitHub Issues) and recommends ticket candidates for the session.
+- **Lock Session & Scope Rules:** \`@intutic start [<ticket_id>] [--sops=<names_or_indices>] [--auto-judge]\`
+  - *Description:* Attributes token costs to a ticket (optional) and scopes active local SOP directories for governance.
+  - *Examples:*
+    * \`@intutic start 1 --sops=3 --auto-judge\`
+    * \`@intutic start --sops=security-rules --auto-judge\`
+
+### 2. FinOps & Token Projections
+- **Predict Costs:** \`@intutic predict <prompt>\`
+  - *Description:* Estimates input/output tokens and cost breakdown before submitting the request to the upstream model.
+- **Optimize Context:** \`@intutic recommend\`
+  - *Description:* Provides recommendations on prompt adjustments and context reduction strategies to minimize token waste.
+
+### 3. Policy Compliance & E2E Judging
+- **Verify Prompt:** \`@intutic verify <prompt>\` (or \`@intutic check <prompt>\`)
+  - *Description:* Audits the prompt pre-flight against active SOPs and guidelines, returning pass/fail verdicts and listing any violations before submitting requests to the LLM.
+- **Review Prompt:** \`@intutic review <prompt>\`
+  - *Description:* Runs a deep heuristic prompt quality evaluation to grade clarity, specificity, and actionability.
+- **Judge Response:** \`@intutic judge <prompt>\`
+  - *Description:* Submits the prompt to the upstream LLM and evaluates the response stream in parallel using LLM-as-a-judge compliance checkers.
+  - *Note:* If no prompt is provided (e.g. \`@intutic judge\`), returns usage instructions.
+- **Inspect Status:** \`@intutic status\` (displays active session stats, average compliance, and spent budget).
+- **Inspect Budget:** \`@intutic budget\` (displays daily monitored limits and workspace progress).
+
+### 4. Posture & Prompt Enhancement
+- **Enhance & Diagnose:** \`/fix <prompt>\` (aliases: \`@fix\`, \`/intutic-fix\`, \`@intutic fix\`)
+  - *Description:* Rewrites the prompt and scores the workspace's governance posture against OWASP categories from what the proxy can see locally — DLP settings, WASM rules, the SOPs on disk for the caller's role, skills and MCP servers. Returns the enhanced prompt plus concrete recommendations for whatever is missing.
+  - *Note:* Blocking by default; it can be configured to pass the enhanced prompt through to the model instead. The recommendations are the handoff points into the rest of the toolchain — "add a WASM rule" is the \`intutic-rule-author\` skill's job, "write a role SOP" and "enable DLP" are handled here.
+- **Draw Guardrails:** \`/draw\` (aliases: \`@draw\`, \`/intutic-draw\`, \`@intutic draw\`)
+  - *Description:* Renders a Mermaid diagram plus text summary of the agent's trajectory and the guardrails currently around it. Always blocking — a visualization has nothing to forward upstream.
+
+---
+
+## 🚦 When a Call Is Refused or Held
+
+Intutic names every refusal with a code: an SDK raises it (\`ClawdeBlockedError.code\`, \`IntuticGateRefusal.code\`), the MCP proxy puts it in \`error.data.code\`, a hook gate that answers in JSON (Cline, Grok Build, Antigravity) puts it in \`code\` beside \`ruleId\`, and the proxy names a withheld answer in its \`x-intutic-refusal\` header. A refusal you read as text, starting \`[Intutic]\` or \`[Intutic Governance]\`, is the same refusal: the call it names did not run (unless it says the result was withheld). Find the code below and act on it.
+
+### Held: tell the user, then wait
+A hold rule wants a person to see this call before it runs. Codes: \`HELD\` (with a hold id, \`hold_…\`), a hook gate's \`[Intutic Governance] HELD:\` message, \`LOOP_RUN_PENDING_REVIEW\` (the loop run is paused for review), and the proxy's \`policy_held\` (a Rego or WASM rule held the request; the error names the hold id). \`SERVER_HELD\` is the MCP registry's version: the server changed its tools in a risky way and waits for an owner or admin on the MCP Servers page.
+- Tell the user what was held and quote the hold id.
+- Only an **Owner, Admin or Engineering Manager** can decide it: \`intutic decision approve <holdId>\` or \`intutic decision reject <holdId>\`, or the Slack card. A developer cannot approve their own hold.
+- Do not retry while it is pending. After approval, the identical call (same tool, same arguments) passes only if the workspace's review-hold bypass (\`reviewHoldBypassEnabled\`) is on, and only for a short window (10 minutes by default); otherwise approval records the decision and a retry is held again. The \`intutic_hold_status\` MCP tool says which.
+- A hold with no hold id could not be recorded, so there is nothing to approve: tell the user.
+
+### Revise: change the approach
+\`policy_reask\` (proxy) and \`REASK\` (MCP proxy) refuse this attempt with a reason. Do something different; repeating it becomes a block (\`policy_denied\`, \`REASK_EXHAUSTED\`).
+
+### Blocked: do not retry the same call
+Continue without it, or tell the user what would have to change and who can change it.
+- **Policy:** \`policy_denied\`, \`TOOL_DENIED\`, \`SOP_RULE\`, \`SNAPSHOT\`, \`HOOK_GATE\`, \`ANOMALY\`, \`WASM_RULE\`, \`REASK_EXHAUSTED\`, \`LOOP_RUN_TERMINATED\`, \`model_not_allowed\`.
+- **Protected by the hook gate:** \`BUILT_IN_RULE\`: a governance bypass, a write to Intutic's own config or a skill directory, or a secret in written content. Do not look for another route to the same change; tell the user.
+- **Identity:** \`SSO_GROUP\`: the user's SSO groups do not clear this tool (rule \`sso_group.high_risk.<tool>\` or \`sso_group.require_obo.<tool>\`). An admin grants the group; you cannot work around it.
+- **Data:** \`dlp_policy_violation\` and \`DLP\` (a secret, destructive command or PII value in the input: remove it), \`INJECTION\` (the input carries a prompt-injection pattern), \`SQL_GUARD\` (destructive SQL against a database not on the SQL allowlist: use an allowlisted database, named explicitly on the command line).
+- **MCP servers:** \`SERVER_BLOCKED\`, \`SERVER_NOT_APPROVED\`, \`TOOL_DISABLED\`, \`SERVER_NOT_ALLOWED\`, \`TOOL_NOT_ALLOWED\`, \`TOOL_DEFINITIONS_CHANGED\`. An owner or admin decides on the MCP Servers page; the \`intutic_mcp_registry_status\` MCP tool shows what the registry says.
+- **Spend:** \`BUDGET_EXCEEDED\`, \`OVERAGE_HARD_CAP_EXCEEDED\`, \`COST_GATE_EXCEEDED\` (a smaller request may pass). An MCP \`BUDGET_EXCEEDED\` lasts until its \`resetAt\`; \`intutic_mcp_budget_remaining\` shows what is left.
+- **Images:** \`E_UNPINNED_LATEST\`, \`E_UNPINNED_TAG\`, \`E_UNKNOWN_REGISTRY\`, \`E_UNKNOWN_IMAGE\`, \`E_DIGEST_MISMATCH\`, \`E_MANIFEST_UNPARSEABLE\`: deploy an image pinned to a digest the image allowlist approves.
+- **Gate setup:** \`WORKFLOW_SANDBOX\`, \`NO_GATE\`: the gate is wired wrongly in the agent's code; fix the code, not the call. \`UNREADABLE_CALL\`: the hook could not read the tool call from its harness, which is a setup fault to report, not something to retry.
+- **Custom rule could not decide:** \`GOVERNANCE_UNAVAILABLE\` whose reason names a custom rule (\`Custom rule <id> reached no verdict (<cause>)\`, rule id \`wasm:<id>\`; cause \`deadline\`, \`budget\`, \`error\`, \`result\` or \`quarantined\`). The rule cannot decide this input, so the same call is refused again however often it is retried. Do not retry it; tell the user, who can fix or remove the rule.
+- **Size:** \`COMMAND_TOO_LARGE\`: the command is over 256 KiB, or the tool's arguments over 1 MiB, more than any gate evaluates. Split the work: smaller commands, or a file written in parts. A hook gate that could not finish deciding in time says \`GATE_DEADLINE\` in its reason; the call did not run, and the same call will be refused again, so tell the user.
+
+### Not checked: retry once, later
+\`GOVERNANCE_UNAVAILABLE\` (unless it names a custom rule: see above), \`REGISTRY_UNAVAILABLE\`, \`BUDGET_UNAVAILABLE\`, \`TOFU_UNAVAILABLE\`, \`RESPONSE_UNPARSEABLE\`, \`GATE_CRASHED\` (the hook gate failed while deciding), \`POLICY_SNAPSHOT_UNVERIFIED\` (the policy snapshot on this machine failed its integrity check, so no MCP call runs until the sync daemon restores it), and \`HOOK_GATE\` when its reason says the control plane was unreachable: governance could not check the call, so it did not run. One later retry is fine; if it fails again, tell the user.
+
+### Ran, but the result was withheld
+\`RESULT_WITHHELD_DLP\`, \`RESULT_WITHHELD_INJECTION\` (MCP proxy) and \`OUTPUT_DLP\` (proxy): the tool or model ran, and its output was not delivered. Do not run it again blindly, since it may already have had its effect; tell the user.
+
+---
+
+## 🛡️ Policy & Hook Verification
+
+1. **Pre-Tool Interception Hooks:**
+   Harness configurations (e.g. \`.claude/settings.json\`, \`.cursor/hooks.json\`) are automatically updated by \`intutic connect\`. They register execution hooks that block unauthorized tools or unsafe commands before execution.
+2. **Local Guidelines & Scoping:**
+   Define local, developer-specific rules inside subdirectories of the \`.intutic/sops/\` directory (e.g. \`.intutic/sops/my-rules/rules.md\`). Initialize them using \`@intutic initialize\` and select active local SOPs using \`@intutic start <ticket> --sops=<indices_or_names>\`. These rules are enforced locally in the developer console to protect developer privacy, while global/corporate rules log incidents back to the control plane.
+3. **Offline Sync & Promotion:**
+   When offline, prompt telemetry is stored locally in sharded files \`~/.intutic/logs/traces-YYYY-MM-DD.jsonl\` and budgets are enforced against sharded daily files \`~/.intutic/logs/local-spend-YYYY-MM-DD.jsonl\`. The sync daemon uploads them automatically on connect via \`/api/v1/traces/sync-back\` and cleans up the local files. Rules can be promoted workspace-wide via \`intutic sops push <name>\`.
+`;
+/** Every skill connect writes, by workspace-relative path. */
+export const BUNDLED_SKILLS = [
+    { path: RULE_AUTHOR_SKILL_PATH, content: RULE_AUTHOR_SKILL },
+    { path: KITKAT_SKILL_PATH, content: KITKAT_SKILL },
+];
 /**
  * Write bundled skills into the workspace, skipping any that already exist.
  * Returns the paths written (empty when everything was already present).
  */
 export async function writeBundledSkills(workspaceRoot) {
     const written = [];
-    const dest = node_path.join(workspaceRoot, RULE_AUTHOR_SKILL_PATH);
-    try {
-        await node_fs.access(dest);
-        return written; // present — never overwrite user edits
-    }
-    catch {
-        // absent → write below
+    for (const skill of BUNDLED_SKILLS) {
+        const dest = node_path.join(workspaceRoot, skill.path);
+        try {
+            await node_fs.access(dest);
+            continue; // present — never overwrite user edits
+        }
+        catch {
+            // absent → write below
+        }
+        // Recorded first, so disconnect knows Intutic created it (and the
+        // directories it needed) and can tell a later edit apart.
+        await keepOriginal(dest, workspaceRoot);
+        await node_fs.mkdir(node_path.dirname(dest), { recursive: true });
+        await node_fs.writeFile(dest, skill.content, 'utf-8');
+        await noteWritten(dest, workspaceRoot, skill.content);
+        written.push(dest);
     }
-    await node_fs.mkdir(node_path.dirname(dest), { recursive: true });
-    await node_fs.writeFile(dest, RULE_AUTHOR_SKILL, 'utf-8');
-    written.push(dest);
     return written;
 }
 //# sourceMappingURL=skillWriter.js.map

package/dist/skillWriter.js.map

@@ -1 +1 @@
-{"version":3,"file":"skillWriter.js","sourceRoot":"","sources":["../src/skillWriter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,SAAS,MAAM,WAAW,CAAA;AAEtC,mEAAmE;AACnE,MAAM,CAAC,MAAM,sBAAsB,GAAG,SAAS,CAAC,IAAI,CAClD,SAAS,EACT,QAAQ,EACR,qBAAqB,EACrB,UAAU,CACX,CAAA;AAED,gFAAgF;AAChF,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2EhC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,aAAqB;IAC5D,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,aAAa,EAAE,sBAAsB,CAAC,CAAA;IAElE,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAC1B,OAAO,OAAO,CAAA,CAAC,uCAAuC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,uBAAuB;IACzB,CAAC;IAED,MAAM,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACjE,MAAM,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAAA;IACzD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAClB,OAAO,OAAO,CAAA;AAChB,CAAC"}
+{"version":3,"file":"skillWriter.js","sourceRoot":"","sources":["../src/skillWriter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,SAAS,MAAM,WAAW,CAAA;AACtC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAErE,mEAAmE;AACnE,MAAM,CAAC,MAAM,sBAAsB,GAAG,SAAS,CAAC,IAAI,CAClD,SAAS,EACT,QAAQ,EACR,qBAAqB,EACrB,UAAU,CACX,CAAA;AAED,gFAAgF;AAChF,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2EhC,CAAA;AAED,8DAA8D;AAC9D,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,2BAA2B,EAAE,UAAU,CAAC,CAAA;AAE7G,sFAAsF;AACtF,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsH3B,CAAA;AAED,8DAA8D;AAC9D,MAAM,CAAC,MAAM,cAAc,GAAqD;IAC9E,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,iBAAiB,EAAE;IAC5D,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,YAAY,EAAE;CACnD,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,aAAqB;IAC5D,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;QACtD,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;YAC1B,SAAQ,CAAC,uCAAuC;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;QACzB,CAAC;QACD,kEAAkE;QAClE,0DAA0D;QAC1D,MAAM,YAAY,CAAC,IAAI,EAAE,aAAa,CAAC,CAAA;QACvC,MAAM,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACjE,MAAM,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACrD,MAAM,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;QACrD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACpB,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/syncCycle.d.ts

@@ -0,0 +1,142 @@
+/**
+ * syncCycle.ts — the per-cycle work `intutic connect` runs against the
+ * control plane.
+ *
+ * `intutic connect` (tools/cli/src/commands/connect.ts) owns the loop: it
+ * polls the control plane, listens for pushed config over the WebSocket, and
+ * on each cycle calls the helpers below. They live here, not in the CLI, so
+ * they can be tested without starting a daemon and so the gate-side caches
+ * are refreshed by exactly one implementation.
+ *
+ * This module used to also hold a second, complete loop (`startSyncLoop`)
+ * that nothing started; the service has always run `connect`. The behaviours
+ * only that loop had and the docs promise (SkillOpt edits, skill findings,
+ * the decisions log, the bundled rule-author skill) are the helpers below and
+ * run from `connect` now, as does its config capture (configReader.ts), which
+ * uploads file content only when the workspace turned that on.
+ *
+ * @module
+ */
+import type { HarnessType, SyncConfigPayload, SyncSopEntry } from '@intutic/shared-types';
+import type { ConfigEditApplyOutcome } from './configWriter.js';
+import type { GovernanceCoverageInputs } from './configReader.js';
+import { type AgentReport } from './agentReporter.js';
+/**
+ * Turns a non-clean `scanSkillContent` result — already computed as part of
+ * `collectAgentReport`'s `facets.skills` — into a `skill_flagged` hook event.
+ *
+ * Deliberately reuses the report the daemon already built for this cycle
+ * rather than re-scanning: `agentReporter.ts`'s `collectSkills` runs
+ * `scanSkillContent` on every `.agents/skills/**\/SKILL.md` as part of
+ * building `facets.skills` already, so this only turns a result the daemon
+ * already has into a visible signal — it does not add a second scan pass.
+ *
+ * Appends directly to `.intutic/events/hook-events.jsonl`, the SAME file
+ * every emitted PreToolUse gate's `log_event`/`logEvent` writes to — not a
+ * new event pipeline. `drainHookEvents` (`claudeCodeHooks.ts`) picks this
+ * line up on its next pass exactly like a gate-written one, because it only
+ * ever reads the file; it does not care who appended a given line.
+ *
+ * Report-only, per `scanSkillContent`'s own doc comment on the unmeasured
+ * false-positive rate against real, benign skill markdown: this NEVER
+ * blocks, mutates, or removes a skill. `hookEvents.ts`'s
+ * `HookEventSchema.event` enum (control plane) counts `skill_flagged`
+ * exactly like `tool_flagged` — advisory telemetry, not an incident.
+ *
+ * A failure to append is caught and warned, never thrown: a governance
+ * telemetry write must not be able to abort the sync cycle it rides in on.
+ */
+export declare function emitSkillFlaggedEvents(opts: {
+    workspaceRoot: string;
+    workspaceId: string;
+    harnessType: HarnessType;
+    skills: AgentReport['facets']['skills'];
+    /** Skills already emitted in this cycle, keyed `source:name`, mutated in
+     *  place. A skill is not harness-specific, and the caller invokes this
+     *  once per harness in the workspace — without a shared set, a workspace
+     *  with two active harnesses would double-emit every flagged skill. */
+    alreadyEmitted: Set<string>;
+}): void;
+/** The credentials every gate-side refresh takes. */
+export interface GateCacheRefreshOptions {
+    controlPlaneUrl: string;
+    apiKey: string;
+    workspaceId: string;
+    /** See {@link PolicySnapshotOptions.localHoldTokens}. */
+    localHoldTokens?: readonly string[];
+}
+/**
+ * The `review_before:` tokens the snapshot compiles into hold rules: from the
+ * synced SOPs' front matter and JSON blocks, the workspace settings, and the
+ * local `.intutic/sops`. The same parse the Claude Code writer runs for its
+ * pattern blacklist, so the two cannot disagree about what is held.
+ */
+export declare function localHoldTokensFor(workspaceRoot: string, sops: SyncSopEntry[], settings: Record<string, unknown> | undefined, harnesses?: HarnessType[]): Promise<string[]>;
+/**
+ * Refresh the three gate-side caches every hook reads: the policy snapshot
+ * (`~/.intutic/hooks/policy-snapshot.rules`), the approved review-hold
+ * bypasses and the central egress policy. Called on EVERY sync cycle, never
+ * only when the config version moved: policy changes without the version
+ * changing, and before this helper existed `connect` refreshed once at
+ * startup and never again, so a guardrail promoted mid-session reached a
+ * connected machine only on restart. None of the three throw; the return
+ * says which of them landed.
+ */
+export declare function refreshGateCaches(opts: GateCacheRefreshOptions): Promise<{
+    snapshot: boolean;
+    bypasses: boolean;
+    egress: boolean;
+}>;
+/** Where the ids of SkillOpt suggestions that fully landed are remembered. */
+export declare const APPLIED_SUGGESTIONS_RELATIVE_PATH: string;
+/**
+ * Apply the SkillOpt config edits the control plane sent with this config,
+ * and ack each outcome back (`POST /api/v1/skillopt/:id/apply-result`). A
+ * suggestion queued for auto-apply reaches `applied` only through that ack.
+ *
+ * Only ids whose every operation landed are remembered in
+ * `.intutic/applied-suggestions.json`, so a failed edit (a fuzzy-match miss,
+ * a refused write) is retried next cycle rather than forgotten. With
+ * `reapplyAll` every edit is applied again regardless: the caller has just
+ * rewritten the harness config files from the SOPs, which drops every overlay
+ * an earlier cycle applied. ADD is idempotent, so re-applying an edit that is
+ * still present changes nothing.
+ *
+ * Never throws: a failed apply or ack must not abort the sync cycle. A
+ * dropped ack only means the suggestion is synced and acked again next cycle.
+ */
+export declare function applySkillOptEdits(opts: {
+    workspaceRoot: string;
+    controlPlaneUrl: string;
+    apiKey: string;
+    appliedEdits: SyncConfigPayload['appliedEdits'];
+    bypassEnforcementTier?: string;
+    reapplyAll: boolean;
+}): Promise<ConfigEditApplyOutcome[]>;
+/**
+ * Register each harness as an agent with its facets, report one session per
+ * harness, and turn this cycle's skill-scan findings into `skill_flagged`
+ * events. Returns each harness's governance-coverage inputs, derived from the
+ * same facets, for the config capture.
+ *
+ * One harness failing must not stop the others, so failures are collected
+ * and returned rather than thrown.
+ */
+export declare function reportHarnessAgents(opts: {
+    controlPlaneUrl: string;
+    apiKey: string;
+    workspaceId: string;
+    workspaceRoot: string;
+    harnesses: readonly HarnessType[];
+    allowLocalVaults?: boolean;
+    /** The local proxy's instance id: the session context lands on its row. */
+    proxyInstanceId?: string | null;
+}): Promise<{
+    governanceInputs: Partial<Record<HarnessType, GovernanceCoverageInputs>>;
+    failures: Array<{
+        harness: HarnessType;
+        error: string;
+    }>;
+}>;
+export declare function syncOfflineTraces(controlPlaneUrl: string, apiKey: string): Promise<void>;
+//# sourceMappingURL=syncCycle.d.ts.map