instar 1.0.10 → 1.0.12

package/dist/core/FrameworkSessionStore.d.ts

@@ -0,0 +1,43 @@
+/**
+ * FrameworkSessionStore — resolve a session's transcript file path for the
+ * runtime that produced it.
+ *
+ * Portability audit Gap 3. PreCompactionFlush and ResumeValidator hardcoded
+ * Claude Code's transcript convention (`~/.claude/projects/<encoded-cwd>/
+ * <sessionId>.jsonl`). A Codex session is never found there, so compaction
+ * flush and resume validation silently no-op for Codex agents.
+ *
+ * Codex's layout was determined empirically from a live ~/.codex/ (Codex CLI
+ * 0.78.0), NOT guessed:
+ *   ~/.codex/sessions/YYYY/MM/DD/rollout-<ISO8601-dashes>-<uuid>.jsonl
+ * where the trailing <uuid> equals the session id (and the first JSONL line
+ * is a `session_meta` record whose payload.id is that same uuid). Sessions
+ * are date-partitioned, NOT cwd-keyed, so a Codex lookup globs by id across
+ * the date tree rather than building a deterministic path.
+ *
+ * Pure path resolution + filesystem lookup. No mutation, no network.
+ */
+export type SessionFramework = 'claude-code' | 'codex-cli';
+export interface ResolveTranscriptOptions {
+    framework: SessionFramework;
+    sessionId: string;
+    /** Project working directory (used by the Claude Code cwd-encoded path). */
+    projectDir: string;
+    /** Home dir override (testing). Defaults to os.homedir(). */
+    homeDir?: string;
+    /**
+     * Root override (testing). For claude-code this replaces
+     * `<home>/.claude/projects`; for codex-cli it replaces
+     * `<home>/.codex/sessions`.
+     */
+    rootOverride?: string;
+}
+/**
+ * Resolve the transcript path for a session under the given framework.
+ * Returns '' when it cannot be resolved (no session id, or — for Codex —
+ * no matching file on disk yet). Callers already treat '' / missing-file
+ * as "nothing to flush/validate", so the failure mode is a safe no-op,
+ * identical to the pre-Gap-3 Claude behavior.
+ */
+export declare function resolveFrameworkTranscriptPath(opts: ResolveTranscriptOptions): string;
+//# sourceMappingURL=FrameworkSessionStore.d.ts.map

package/dist/core/FrameworkSessionStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FrameworkSessionStore.d.ts","sourceRoot":"","sources":["../../src/core/FrameworkSessionStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,WAAW,CAAC;AAE3D,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAoDD;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,wBAAwB,GAAG,MAAM,CASrF"}

package/dist/core/FrameworkSessionStore.js

@@ -0,0 +1,90 @@
+/**
+ * FrameworkSessionStore — resolve a session's transcript file path for the
+ * runtime that produced it.
+ *
+ * Portability audit Gap 3. PreCompactionFlush and ResumeValidator hardcoded
+ * Claude Code's transcript convention (`~/.claude/projects/<encoded-cwd>/
+ * <sessionId>.jsonl`). A Codex session is never found there, so compaction
+ * flush and resume validation silently no-op for Codex agents.
+ *
+ * Codex's layout was determined empirically from a live ~/.codex/ (Codex CLI
+ * 0.78.0), NOT guessed:
+ *   ~/.codex/sessions/YYYY/MM/DD/rollout-<ISO8601-dashes>-<uuid>.jsonl
+ * where the trailing <uuid> equals the session id (and the first JSONL line
+ * is a `session_meta` record whose payload.id is that same uuid). Sessions
+ * are date-partitioned, NOT cwd-keyed, so a Codex lookup globs by id across
+ * the date tree rather than building a deterministic path.
+ *
+ * Pure path resolution + filesystem lookup. No mutation, no network.
+ */
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+/**
+ * Claude Code: deterministic path
+ * `<home>/.claude/projects/<cwd with [/.] → ->/<sessionId>.jsonl`.
+ * This mirrors the exact pre-Gap-3 logic in PreCompactionFlush so the
+ * Claude path is byte-for-byte unchanged.
+ */
+function claudeTranscriptPath(opts) {
+    const home = opts.homeDir ?? os.homedir();
+    const root = opts.rootOverride ?? path.join(home, '.claude', 'projects');
+    const encoded = opts.projectDir.replace(/[\/.]/g, '-');
+    return path.join(root, encoded, `${opts.sessionId}.jsonl`);
+}
+/**
+ * Codex CLI: glob `<home>/.codex/sessions/YYYY/MM/DD/rollout-*-<id>.jsonl`.
+ * Empirically the filename ends with `-<sessionId>.jsonl`. Returns the
+ * first match (a session id is unique), or '' when not found.
+ */
+function codexTranscriptPath(opts) {
+    const home = opts.homeDir ?? os.homedir();
+    const root = opts.rootOverride ?? path.join(home, '.codex', 'sessions');
+    if (!fs.existsSync(root))
+        return '';
+    const suffix = `-${opts.sessionId}.jsonl`;
+    // sessions/YYYY/MM/DD/<file>. Walk at most 3 levels deep.
+    const years = safeReaddir(root);
+    for (const y of years) {
+        const yDir = path.join(root, y);
+        for (const m of safeReaddir(yDir)) {
+            const mDir = path.join(yDir, m);
+            for (const d of safeReaddir(mDir)) {
+                const dDir = path.join(mDir, d);
+                for (const f of safeReaddir(dDir)) {
+                    if (f.startsWith('rollout-') && f.endsWith(suffix)) {
+                        return path.join(dDir, f);
+                    }
+                }
+            }
+        }
+    }
+    return '';
+}
+function safeReaddir(dir) {
+    try {
+        return fs.readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Resolve the transcript path for a session under the given framework.
+ * Returns '' when it cannot be resolved (no session id, or — for Codex —
+ * no matching file on disk yet). Callers already treat '' / missing-file
+ * as "nothing to flush/validate", so the failure mode is a safe no-op,
+ * identical to the pre-Gap-3 Claude behavior.
+ */
+export function resolveFrameworkTranscriptPath(opts) {
+    if (!opts.sessionId)
+        return '';
+    switch (opts.framework) {
+        case 'codex-cli':
+            return codexTranscriptPath(opts);
+        case 'claude-code':
+        default:
+            return claudeTranscriptPath(opts);
+    }
+}
+//# sourceMappingURL=FrameworkSessionStore.js.map

package/dist/core/FrameworkSessionStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FrameworkSessionStore.js","sourceRoot":"","sources":["../../src/core/FrameworkSessionStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAmBlC;;;;;GAKG;AACH,SAAS,oBAAoB,CAAC,IAA8B;IAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;IAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IACzE,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACvD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,SAAS,QAAQ,CAAC,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,SAAS,mBAAmB,CAAC,IAA8B;IACzD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;IAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IACxE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,SAAS,QAAQ,CAAC;IAC1C,0DAA0D;IAC1D,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAChC,KAAK,MAAM,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAChC,KAAK,MAAM,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;gBAChC,KAAK,MAAM,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;oBAClC,IAAI,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;wBACnD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;oBAC5B,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,WAAW,CAAC,GAAW;IAC9B,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,8BAA8B,CAAC,IAA8B;IAC3E,IAAI,CAAC,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,CAAC;IAC/B,QAAQ,IAAI,CAAC,SAAS,EAAE,CAAC;QACvB,KAAK,WAAW;YACd,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACnC,KAAK,aAAa,CAAC;QACnB;YACE,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;AACH,CAAC"}

package/dist/core/PostUpdateMigrator.d.ts

@@ -45,6 +45,22 @@ export declare class PostUpdateMigrator {
      */
     private stepEngine;
     constructor(config: MigratorConfig);
+    /**
+     * Resolve the set of frameworks this install actively uses, read from
+     * the persisted `.instar/config.json` `enabledFrameworks` field.
+     *
+     * Default (unset / empty / unreadable): `['claude-code']` — the
+     * historical behavior, so existing and dual-framework installs are
+     * unaffected. A Codex-only install sets `enabledFrameworks:
+     * ['codex-cli']`, which makes framework-specific migration steps that
+     * scaffold `.claude/`-only artifacts skip cleanly instead of writing
+     * files that runtime will never read.
+     *
+     * Single source of truth for the migrator's framework gating — both
+     * the parity-renderings backfill and the legacy `.claude/`-specific
+     * steps consult this.
+     */
+    private getEnabledFrameworks;
     /**
      * F-7 atomic-step primitive: register a step that will run once on
      * the release boundary where `step.version <= toVersion`. Idempotent

package/dist/core/PostUpdateMigrator.d.ts.map

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

package/dist/core/PostUpdateMigrator.js

@@ -52,6 +52,37 @@ export class PostUpdateMigrator {
     constructor(config) {
         this.config = config;
     }
+    /**
+     * Resolve the set of frameworks this install actively uses, read from
+     * the persisted `.instar/config.json` `enabledFrameworks` field.
+     *
+     * Default (unset / empty / unreadable): `['claude-code']` — the
+     * historical behavior, so existing and dual-framework installs are
+     * unaffected. A Codex-only install sets `enabledFrameworks:
+     * ['codex-cli']`, which makes framework-specific migration steps that
+     * scaffold `.claude/`-only artifacts skip cleanly instead of writing
+     * files that runtime will never read.
+     *
+     * Single source of truth for the migrator's framework gating — both
+     * the parity-renderings backfill and the legacy `.claude/`-specific
+     * steps consult this.
+     */
+    getEnabledFrameworks() {
+        try {
+            const configPath = path.join(this.config.stateDir, 'config.json');
+            const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+            const enabled = config.enabledFrameworks;
+            if (Array.isArray(enabled) && enabled.length > 0) {
+                const filtered = enabled.filter((f) => f === 'claude-code' || f === 'codex-cli');
+                if (filtered.length > 0)
+                    return filtered;
+            }
+        }
+        catch {
+            // fall through to default
+        }
+        return ['claude-code'];
+    }
     /**
      * F-7 atomic-step primitive: register a step that will run once on
      * the release boundary where `step.version <= toVersion`. Idempotent
@@ -237,15 +268,8 @@ export class PostUpdateMigrator {
         // Lazy-import registry so PostUpdateMigrator doesn't pull the entire
         // parity graph at startup for agents that never invoke migrate().
         const { listParityRules } = await import('../providers/parity/registry.js');
-        // Determine enabled frameworks from config — default to claude-code+codex-cli
-        // for portable agents, claude-code-only as a safe fallback.
-        const frameworks = (() => {
-            const enabled = config.enabledFrameworks;
-            if (Array.isArray(enabled) && enabled.length > 0) {
-                return enabled.filter(f => f === 'claude-code' || f === 'codex-cli');
-            }
-            return ['claude-code'];
-        })();
+        // Single source of truth for framework gating (see getEnabledFrameworks).
+        const frameworks = this.getEnabledFrameworks();
         const rules = listParityRules();
         let renderedCount = 0;
         let skippedCount = 0;
@@ -2126,6 +2150,17 @@ The user has been talking to you (possibly for days). A generic greeting like "H
      * Migrates legacy PostToolUse/Notification hooks to proper SessionStart type.
      */
     migrateSettings(result) {
+        // Framework gate (portability audit Gap 5). `.claude/settings.json` is
+        // Claude Code's hook/MCP configuration — it has zero meaning for a
+        // Codex-only runtime. Skip the entire step when claude-code is not in
+        // the enabled set so a Codex-only install is not scaffolded with
+        // `.claude/` artifacts it will never read. Default (unset config) is
+        // ['claude-code'], so existing and dual-framework installs are
+        // unaffected.
+        if (!this.getEnabledFrameworks().includes('claude-code')) {
+            result.skipped.push('.claude/settings.json (skipped — claude-code not in enabledFrameworks)');
+            return;
+        }
         const settingsPath = path.join(this.config.projectDir, '.claude', 'settings.json');
         if (!fs.existsSync(settingsPath)) {
             result.skipped.push('.claude/settings.json (not found — will be created on next init)');