@intutic/sync-daemon 2.1.0 → 2.3.0

package/dist/configWriter.d.ts

@@ -1,54 +1,44 @@
 /**
- * configWriter.ts — Write SOP content to harness config files.
+ * configWriter.ts — the harness rules-file map, local SOP loading, SkillOpt
+ * config edits and the atomic write they share.
  *
- * Each harness (Cursor, Claude Code, Antigravity, Windsurf, Aider,
- * OpenHands, Codex) has a distinct config file format. This module
- * resolves paths, formats content, and performs atomic writes
- * (write-to-tmp → rename) to prevent partial/corrupt files.
- *
- * HLD §3.14 — Real-Time State Mirroring
- * LLD #8 — Sync Daemon / CLI
+ * The harness config files themselves are written by the CLI's adapters
+ * (tools/cli/src/harness), which `intutic connect` runs.
  *
  * @module
  */
 import type { HarnessType, SyncSopEntry, ConfigEdit } from '@intutic/shared-types';
 /**
- * Maps each harness type to its expected config filename relative to
- * the workspace root. Empty string means the harness is deferred to
- * Phase 2 (e.g., n8n — TD-037).
+ * Clear the macOS user-immutable flag so the daemon can rewrite a file it
+ * write-protected (the workspace's `bypassEnforcementTier: 'immutable'`).
+ * No-op on other platforms or if the file does not exist yet.
+ */
+export declare function clearImmutable(filePath: string): Promise<void>;
+/**
+ * Set the macOS user-immutable flag (`chflags uchg`), so a hand edit of a
+ * managed file fails with EPERM. The flag needs no root to set or clear; it
+ * stops casual editing, not a determined user. No-op on other platforms.
+ */
+export declare function setImmutable(filePath: string): Promise<void>;
+/** Every adapter that writes `.env.intutic`: Codex and the SDK-gated frameworks. */
+export declare const ENV_INTUTIC_WRITERS: readonly string[];
+/**
+ * The workspace file captured, watched for drift and edited by SkillOpt for
+ * each harness: its rules file (`rulesFileOf`, from `HARNESS_RULES_FILES` in
+ * `@intutic/shared-types`), else `.env.intutic` for the SDK-gated frameworks,
+ * which carries their proxy variables. An empty string means nothing in the
+ * workspace: the harness's rule sets go elsewhere (OpenClaw's agent
+ * workspace) or nowhere (see the map's `none` entries).
  */
 export declare const HARNESS_FILES: Record<HarnessType, string>;
-/** Result of a config-write operation across one or more harnesses. */
-export interface WriteResult {
-    /** Paths of files that were successfully written. */
-    filesWritten: string[];
-    /** Paths where the harness was skipped (not detected or deferred). */
-    filesSkipped: string[];
-}
 /**
  * The workspace's local SOPs (`.intutic/sops/<dir>/*.md`, narrowed by
- * `session-context.json`'s `activeLocalSops` when present). Shared by the
- * config writer and by the gate-cache refresh, which compiles their
- * `review_before:` tokens into hold rules (TD-474 item 4). A missing
+ * `session-context.json`'s `activeLocalSops` when present). Read by the
+ * gate-cache refresh, which compiles their
+ * `review_before:` tokens into hold rules. A missing
  * directory is an empty list.
  */
 export declare function loadLocalSopEntries(workspaceRoot: string, harnesses: HarnessType[]): Promise<SyncSopEntry[]>;
-/**
- * Write SOP content to all targeted harness config files.
- *
- * For each harness type, resolves the config file path, formats the
- * content according to the harness-specific format, and performs an
- * atomic write (tmp file → rename).
- *
- * @param workspaceRoot - Absolute path to the workspace root.
- * @param sops - SOPs to write, each specifying which harnesses to target.
- * @param proxyUrl - Intutic proxy URL for LLM API redirect.
- * @param harnesses - Harness types detected in the workspace.
- * @returns WriteResult with written and skipped file paths.
- */
-export declare function writeConfigFiles(workspaceRoot: string, sops: SyncSopEntry[], proxyUrl: string, harnesses: HarnessType[], workspaceId?: string, 
-/** WS-5 Q3: 'rewrite' (default) | 'immutable' | 'alert-only' */
-bypassEnforcementTier?: string): Promise<WriteResult>;
 /** Outcome of a single ADD/DELETE/REPLACE operation within one suggestion's edit set. */
 export interface ConfigEditOperationOutcome {
     /** Index into the suggestion's `edits` array. */
@@ -61,8 +51,7 @@ export interface ConfigEditOperationOutcome {
 }
 /**
  * Per-suggestion result of `applyConfigEdits` — what the daemon reports back
- * to control-plane via `POST /api/v1/skillopt/:suggestionId/apply-result`
- * (TD-349).
+ * to control-plane via `POST /api/v1/skillopt/:suggestionId/apply-result`.
  */
 export interface ConfigEditApplyOutcome {
     suggestionId: string;
@@ -73,11 +62,11 @@ export interface ConfigEditApplyOutcome {
 /**
  * Apply a list of custom config edits (ADD, DELETE, REPLACE) to a workspace rule file.
  *
- * Returns one `ConfigEditApplyOutcome` per input suggestion (TD-349) instead
+ * Returns one `ConfigEditApplyOutcome` per input suggestion instead
  * of `void` — every operation's real fate (fuzzy-match miss on DELETE/
  * REPLACE, an unresolvable target file, or the final `atomicWrite` itself
  * failing) is recorded here rather than only `console.warn`'d, so the caller
- * (syncLoop.ts) can ack the daemon's actual outcome back to control-plane
+ * (`applySkillOptEdits`, syncCycle.ts) can ack the daemon's actual outcome back to control-plane
  * instead of the daemon-side write being invisible to it.
  */
 export declare function applyConfigEdits(workspaceRoot: string, appliedEdits: Array<{
@@ -93,11 +82,9 @@ export declare function applyConfigEdits(workspaceRoot: string, appliedEdits: Ar
  * This prevents partial/corrupt files if the process is interrupted mid-write.
  *
  * If bypassEnforcementTier === 'immutable', clears the macOS user-immutable
- * flag before writing and re-sets it after (WS-5 Q3).
+ * flag before writing and re-sets it after.
  *
- * Exported for reuse by other full-regenerate writers in this daemon (e.g.
- * `lib/decisionsDigest.ts`) that want the same write-tmp-then-rename
- * atomicity without duplicating it.
+ * Exported for `lib/decisionsDigest.ts`, which regenerates whole files too.
  */
 export declare function atomicWrite(filePath: string, content: string, bypassEnforcementTier?: string): Promise<void>;
 //# sourceMappingURL=configWriter.d.ts.map

package/dist/configWriter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configWriter.d.ts","sourceRoot":"","sources":["../src/configWriter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AA2ClF;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CA2GrD,CAAA;AAID,uEAAuE;AACvE,MAAM,WAAW,WAAW;IAC1B,qDAAqD;IACrD,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,sEAAsE;IACtE,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CA0ClH;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CACpC,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,YAAY,EAAE,EACpB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,WAAW,EAAE,EACxB,WAAW,SAAK;AAChB,gEAAgE;AAChE,qBAAqB,CAAC,EAAE,MAAM,GAC7B,OAAO,CAAC,WAAW,CAAC,CA0JtB;AAkCD,yFAAyF;AACzF,MAAM,WAAW,0BAA0B;IACzC,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,2EAA2E;IAC3E,OAAO,EAAE,OAAO,CAAA;IAChB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAA;IACpB,iEAAiE;IACjE,EAAE,EAAE,OAAO,CAAA;IACX,YAAY,EAAE,0BAA0B,EAAE,CAAA;CAC3C;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,KAAK,CAAC;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,CAAA;CAC7B,CAAC,EACF,qBAAqB,CAAC,EAAE,MAAM,GAC7B,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAqHnC;AAyZD;;;;;;;;;;;;GAYG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,qBAAqB,CAAC,EAAE,MAAM,GAC7B,OAAO,CAAC,IAAI,CAAC,CAiBf"}
+{"version":3,"file":"configWriter.d.ts","sourceRoot":"","sources":["../src/configWriter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAIlF;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGpE;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlE;AAID,oFAAoF;AACpF,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAmBhD,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAEtB,CAAA;AAEhC;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CA0ClH;AAkCD,yFAAyF;AACzF,MAAM,WAAW,0BAA0B;IACzC,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,2EAA2E;IAC3E,OAAO,EAAE,OAAO,CAAA;IAChB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAA;IACpB,iEAAiE;IACjE,EAAE,EAAE,OAAO,CAAA;IACX,YAAY,EAAE,0BAA0B,EAAE,CAAA;CAC3C;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,KAAK,CAAC;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,CAAA;CAC7B,CAAC,EACF,qBAAqB,CAAC,EAAE,MAAM,GAC7B,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAuHnC;AAID;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,qBAAqB,CAAC,EAAE,MAAM,GAC7B,OAAO,CAAC,IAAI,CAAC,CAiBf"}