instar 0.28.45 → 0.28.46

package/dist/commands/ledgerCleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledgerCleanup.d.ts","sourceRoot":"","sources":["../../src/commands/ledgerCleanup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,iEAAiE;IACjE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0BAA0B;IAC1B,eAAe,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CAC1D;AAED,wBAAsB,aAAa,CACjC,IAAI,GAAE,oBAAyB,GAC9B,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAiEpE"}

package/dist/commands/ledgerCleanup.js

@@ -0,0 +1,71 @@
+/**
+ * `instar ledger cleanup` — deletes orphaned Integrated-Being ledger files
+ * when the feature is disabled. Safe to run when enabled — it refuses to
+ * delete active ledger data unless --force is passed.
+ *
+ * Spec: docs/specs/integrated-being-ledger-v1.md §"Rollback plan".
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import pc from 'picocolors';
+import { loadConfig } from '../core/Config.js';
+export async function ledgerCleanup(opts = {}) {
+    const cfg = opts._configOverride ?? (() => {
+        const c = loadConfig(opts.dir);
+        const enabled = c.integratedBeing?.enabled;
+        return {
+            stateDir: c.stateDir,
+            // Default: enabled when undefined
+            enabled: enabled === undefined ? true : enabled !== false,
+        };
+    })();
+    // Refuse to run when feature is enabled unless --force
+    if (cfg.enabled && !opts.force) {
+        console.log(pc.yellow('Integrated-Being ledger is ENABLED. Refusing to delete active ledger data.'));
+        console.log(pc.yellow('Either disable it in config (integratedBeing.enabled=false) and re-run, or pass --force.'));
+        return { deleted: [], skipped: [], reason: 'feature still enabled' };
+    }
+    const patterns = [
+        'shared-state.jsonl',
+        'shared-state.jsonl.stats.json',
+        'shared-state.jsonl.prune-lastrun',
+    ];
+    const stateDir = cfg.stateDir;
+    const toDelete = [];
+    try {
+        const entries = fs.readdirSync(stateDir);
+        for (const name of entries) {
+            if (patterns.includes(name) || /^shared-state\.jsonl\.\d+$/.test(name)) {
+                toDelete.push(name);
+            }
+        }
+    }
+    catch {
+        return { deleted: [], skipped: [], reason: 'stateDir unreadable' };
+    }
+    if (toDelete.length === 0) {
+        console.log(pc.green('No Integrated-Being ledger files to clean up.'));
+        return { deleted: [], skipped: [] };
+    }
+    if (!opts.yes) {
+        console.log(pc.yellow(`Would delete ${toDelete.length} file(s):`));
+        for (const f of toDelete)
+            console.log(`  ${f}`);
+        console.log(pc.yellow('Re-run with --yes to actually delete.'));
+        return { deleted: [], skipped: toDelete, reason: 'dry-run — use --yes' };
+    }
+    const deleted = [];
+    const skipped = [];
+    for (const name of toDelete) {
+        try {
+            fs.unlinkSync(path.join(stateDir, name));
+            deleted.push(name);
+        }
+        catch {
+            skipped.push(name);
+        }
+    }
+    console.log(pc.green(`Deleted ${deleted.length} ledger file(s).`));
+    return { deleted, skipped };
+}
+//# sourceMappingURL=ledgerCleanup.js.map

package/dist/commands/ledgerCleanup.js.map

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

package/dist/commands/migrate.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Migration CLI commands for Integrated-Being v1.
+ *
+ * `instar migrate sync-session-hook` — overwrites .claude/hooks/instar/session-start.sh
+ * with the latest `PostUpdateMigrator.getSessionStartHook()` output. Used by
+ * divergent-local-hook agents (e.g., Echo) to pick up the new /shared-state/render
+ * injection after an update.
+ *
+ * Spec: docs/specs/integrated-being-ledger-v1.md §"Session-start injection".
+ */
+export interface SyncSessionHookOptions {
+    dir?: string;
+    /** Overwrite without prompting. */
+    force?: boolean;
+    /** Test-only override — supplies config instead of reading from disk. */
+    _configOverride?: {
+        projectDir: string;
+        stateDir: string;
+        port: number;
+        projectName: string;
+        hasTelegram?: boolean;
+    };
+}
+/**
+ * Entry point for `instar migrate sync-session-hook`.
+ * Returns { changed, path, reason } for tests / scripting.
+ */
+export declare function syncSessionHook(opts?: SyncSessionHookOptions): Promise<{
+    changed: boolean;
+    path: string;
+    reason?: string;
+}>;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/commands/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/commands/migrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,MAAM,WAAW,sBAAsB;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,yEAAyE;IACzE,eAAe,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACtH;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,IAAI,GAAE,sBAA2B,GAChC,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAkD9D"}

package/dist/commands/migrate.js

@@ -0,0 +1,63 @@
+/**
+ * Migration CLI commands for Integrated-Being v1.
+ *
+ * `instar migrate sync-session-hook` — overwrites .claude/hooks/instar/session-start.sh
+ * with the latest `PostUpdateMigrator.getSessionStartHook()` output. Used by
+ * divergent-local-hook agents (e.g., Echo) to pick up the new /shared-state/render
+ * injection after an update.
+ *
+ * Spec: docs/specs/integrated-being-ledger-v1.md §"Session-start injection".
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import pc from 'picocolors';
+import { loadConfig } from '../core/Config.js';
+import { PostUpdateMigrator } from '../core/PostUpdateMigrator.js';
+/**
+ * Entry point for `instar migrate sync-session-hook`.
+ * Returns { changed, path, reason } for tests / scripting.
+ */
+export async function syncSessionHook(opts = {}) {
+    const cfg = opts._configOverride ?? (() => {
+        const c = loadConfig(opts.dir);
+        return {
+            projectDir: c.projectDir,
+            stateDir: c.stateDir,
+            port: c.port,
+            projectName: c.projectName,
+            hasTelegram: c.messaging?.some((m) => m.type === 'telegram') ?? false,
+        };
+    })();
+    const migrator = new PostUpdateMigrator({
+        projectDir: cfg.projectDir,
+        stateDir: cfg.stateDir,
+        port: cfg.port,
+        hasTelegram: cfg.hasTelegram ?? false,
+        projectName: cfg.projectName,
+    });
+    const hookContent = migrator.getSessionStartHook();
+    const hookDir = path.join(cfg.projectDir, '.claude', 'hooks', 'instar');
+    const hookPath = path.join(hookDir, 'session-start.sh');
+    fs.mkdirSync(hookDir, { recursive: true });
+    let existing = null;
+    try {
+        existing = fs.readFileSync(hookPath, 'utf-8');
+    }
+    catch { /* first install */ }
+    if (existing === hookContent) {
+        return { changed: false, path: hookPath, reason: 'already up to date' };
+    }
+    if (existing !== null && !opts.force) {
+        // Divergent hook detected — require --force to overwrite
+        const divergent = existing.length > 0;
+        if (divergent) {
+            console.log(pc.yellow(`Existing hook at ${hookPath} differs from the default template.`));
+            console.log(pc.yellow(`Re-run with --force to overwrite (your custom changes will be replaced).`));
+            return { changed: false, path: hookPath, reason: 'divergent — use --force' };
+        }
+    }
+    fs.writeFileSync(hookPath, hookContent, { mode: 0o755 });
+    console.log(pc.green(`Wrote ${hookPath}`));
+    return { changed: true, path: hookPath };
+}
+//# sourceMappingURL=migrate.js.map

package/dist/commands/migrate.js.map

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

package/dist/commands/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/commands/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA2PH,UAAU,YAAY;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;2DACuD;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA81CD,wBAAsB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAkwItE;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsDzE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuD5E"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/commands/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA2PH,UAAU,YAAY;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;2DACuD;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA81CD,wBAAsB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA+yItE;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsDzE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuD5E"}

package/dist/commands/server.js

@@ -5209,7 +5209,51 @@ export async function startServer(options) {
                 return { content: lines.join('\n'), truncated: false, elapsedMs: Date.now() - start };
             }, { description: 'Feature discovery state and behavioral contract summary' });
         }
-        const server = new AgentServer({ config, sessionManager, state, scheduler, telegram, relationships, feedback, feedbackAnomalyDetector, dispatches, updateChecker, autoUpdater, autoDispatcher, quotaTracker, quotaManager, publisher, viewer, tunnel, evolution, watchdog, topicMemory, triageNurse, projectMapper, coherenceGate: scopeVerifier, contextHierarchy, canonicalState, operationGate, sentinel, adaptiveTrust, memoryMonitor, orphanReaper, coherenceMonitor, commitmentTracker, semanticMemory, activitySentinel, messageRouter, summarySentinel, spawnManager, systemReviewer, capabilityMapper, selfKnowledgeTree, coverageAuditor, topicResumeMap: _topicResumeMap ?? undefined, autonomyManager, trustElevationTracker, autonomousEvolution, coordinator: coordinator.enabled ? coordinator : undefined, localSigningKeyPem, whatsapp: whatsappAdapter, slack: slackAdapter, imessage: imessageAdapter, whatsappBusinessBackend, messageBridge, hookEventReceiver, worktreeMonitor, subagentTracker, instructionsVerifier, handshakeManager: threadlineHandshake, threadlineRouter, threadlineRelayClient, threadlineReplyWaiters, listenerManager: listenerManager ?? undefined, responseReviewGate, messagingToneGate, outboundDedupGate, telemetryHeartbeat, pasteManager, featureRegistry, discoveryEvaluator, unifiedTrust, liveConfig });
+        // ── Integrated-Being ledger (v1) ──────────────────────────────────
+        // Spec: docs/specs/integrated-being-ledger-v1.md
+        let sharedStateLedger;
+        {
+            const ibConfig = config.integratedBeing ?? {};
+            const ibEnabled = ibConfig.enabled === undefined ? true : ibConfig.enabled !== false;
+            if (ibEnabled) {
+                const { SharedStateLedger } = await import('../core/SharedStateLedger.js');
+                const { randomBytes } = await import('node:crypto');
+                // Generate salt on first use — persisted via LiveConfig.
+                let salt = ibConfig.counterpartyHashSalt ?? '';
+                if (!salt) {
+                    salt = randomBytes(32).toString('hex');
+                    try {
+                        if (liveConfig)
+                            liveConfig.set('integratedBeing.counterpartyHashSalt', salt);
+                    }
+                    catch { /* best effort */ }
+                }
+                sharedStateLedger = new SharedStateLedger({
+                    stateDir: config.stateDir,
+                    config: ibConfig,
+                    salt,
+                    degradationReporter,
+                });
+                // Wire emitters (single call-site; revert = delete this block).
+                const { registerLedgerEmitters } = await import('../core/registerLedgerEmitters.js');
+                // Note: dispatchExecutor is scoped inside the dispatches.enabled block.
+                // AutoDispatcher wraps it; the emitter sink is set via
+                // autoDispatcher.executor.setLedgerEventSink(). We access it through
+                // autoDispatcher — if dispatches are disabled, no emitter is installed.
+                const dispatchExec = autoDispatcher
+                    ? autoDispatcher.executor
+                    : undefined;
+                registerLedgerEmitters(sharedStateLedger, {
+                    threadlineRouter: threadlineRouter ?? undefined,
+                    dispatchExecutor: dispatchExec ?? undefined,
+                    coherenceGate: responseReviewGate ?? undefined,
+                    config: ibConfig,
+                    instance: config.projectName ?? 'server',
+                });
+                console.log(pc.green('  Integrated-Being ledger: enabled'));
+            }
+        }
+        const server = new AgentServer({ config, sessionManager, state, scheduler, telegram, relationships, feedback, feedbackAnomalyDetector, dispatches, updateChecker, autoUpdater, autoDispatcher, quotaTracker, quotaManager, publisher, viewer, tunnel, evolution, watchdog, topicMemory, triageNurse, projectMapper, coherenceGate: scopeVerifier, contextHierarchy, canonicalState, operationGate, sentinel, adaptiveTrust, memoryMonitor, orphanReaper, coherenceMonitor, commitmentTracker, semanticMemory, activitySentinel, messageRouter, summarySentinel, spawnManager, systemReviewer, capabilityMapper, selfKnowledgeTree, coverageAuditor, topicResumeMap: _topicResumeMap ?? undefined, autonomyManager, trustElevationTracker, autonomousEvolution, coordinator: coordinator.enabled ? coordinator : undefined, localSigningKeyPem, whatsapp: whatsappAdapter, slack: slackAdapter, imessage: imessageAdapter, whatsappBusinessBackend, messageBridge, hookEventReceiver, worktreeMonitor, subagentTracker, instructionsVerifier, handshakeManager: threadlineHandshake, threadlineRouter, threadlineRelayClient, threadlineReplyWaiters, listenerManager: listenerManager ?? undefined, responseReviewGate, messagingToneGate, outboundDedupGate, telemetryHeartbeat, pasteManager, featureRegistry, discoveryEvaluator, unifiedTrust, liveConfig, sharedStateLedger });
         await server.start();
         // Connect DegradationReporter downstream systems now that everything is initialized.
         // Any degradation events queued during startup will drain to feedback + telegram.
@@ -5513,6 +5557,11 @@ export async function startServer(options) {
             // when better-sqlite3 destructors fire during process teardown.
             topicMemory?.close();
             semanticMemory?.close();
+            // Integrated-Being v1 — flush stats sidecar (coalesces pending writes).
+            try {
+                sharedStateLedger?.shutdown();
+            }
+            catch { /* best effort */ }
             await server.stop();
             process.exit(0);
         };