@hearsay-tools/squawk 0.0.0-stage → 0.17.0-dev.5685

package/dist/agent-config/service.js

@@ -0,0 +1,73 @@
+import { productIdentity } from '../home/identity.js';
+import { defined } from '../core/defined.js';
+import { readFile } from 'node:fs/promises';
+import { agentHomePaths, claudeStateFilePath } from '../paths.js';
+import { CONFIG_FILES } from './catalog.js';
+import { hashBytes, statConfigPath } from './files.js';
+const HOSTED_REASON = `agent config is read-only on this remote cockpit; run \`${productIdentity().command} remote-settings enable\` on the host to allow edits`;
+/** ~/.claude.json can be large (per-project history); cap the read. */
+const CLAUDE_JSON_CAP = 2 * 1024 * 1024;
+async function versionOf(path, exists) {
+    if (!exists)
+        return null;
+    try {
+        return hashBytes(await readFile(path, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+/** Read the user-scope MCP server *names* from ~/.claude.json — never its contents, never for writing. */
+export async function readUserMcpServers(env) {
+    // Claude's own MCP state file. Sibling of `~/.claude/` by default, INSIDE the
+    // dir once CLAUDE_CONFIG_DIR relocates it — `claudeStateFilePath` owns that rule.
+    const path = claudeStateFilePath(agentHomePaths(env).claude, env);
+    try {
+        const { size } = await statConfigPath(path);
+        if (size > CLAUDE_JSON_CAP)
+            return { path, servers: [], readable: false };
+        const raw = await readFile(path, 'utf8');
+        const parsed = JSON.parse(raw);
+        const servers = parsed.mcpServers && typeof parsed.mcpServers === 'object' ? Object.keys(parsed.mcpServers) : [];
+        return { path, servers, readable: true };
+    }
+    catch (err) {
+        // ENOENT → readable (no servers); anything else → not readable
+        if (err.code === 'ENOENT')
+            return { path, servers: [], readable: true };
+        return { path, servers: [], readable: false };
+    }
+}
+export async function listAgentConfig(repoRoot, env, editable) {
+    const home = agentHomePaths(env);
+    const files = await Promise.all(CONFIG_FILES.map(async (def) => {
+        const path = def.resolve(repoRoot, home);
+        const { exists, size } = await statConfigPath(path);
+        return defined({
+            id: def.id,
+            runners: def.runners,
+            kind: def.kind,
+            scope: def.scope,
+            label: def.label,
+            path,
+            format: def.format,
+            tracked: def.tracked,
+            seeded: Boolean(def.seeded),
+            holdsMcp: Boolean(def.holdsMcp),
+            precedence: def.precedence,
+            hotReload: def.hotReload,
+            docsUrl: def.docsUrl,
+            exists,
+            size,
+            version: await versionOf(path, exists),
+            writable: editable,
+            readOnlyReason: editable ? undefined : HOSTED_REASON,
+        });
+    }));
+    return {
+        editable,
+        files,
+        userMcp: editable ? await readUserMcpServers(env) : null,
+    };
+}
+//# sourceMappingURL=service.js.map

package/dist/agent-config/service.js.map

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

package/dist/agent-config/validate.d.ts

@@ -0,0 +1,18 @@
+import type { ConfigFormat } from './catalog.ts';
+/**
+ * Validate format syntax only. Do not validate a vendor schema or reserialize the user’s text.
+ */
+export interface ValidationResult {
+    ok: boolean;
+    /** Human-readable parser message when `ok` is false. */
+    error?: string;
+}
+/**
+ * Strip `//` line and slash-star block comments from JSONC, string-aware so a
+ * `//` or `/*` inside a JSON string is preserved. Whitespace-preserving (spans
+ * are blanked, not removed) so parser error offsets still line up with the
+ * source. Only used to validate — the original bytes are what gets written.
+ */
+export declare function stripJsonComments(input: string): string;
+/** Validate `content` against `format`. Markdown is always valid; empty is always valid (a new file). */
+export declare function validateConfig(content: string, format: ConfigFormat): ValidationResult;

package/dist/agent-config/validate.js

@@ -0,0 +1,82 @@
+import { parse as parseToml } from 'smol-toml';
+import { parse as parseYaml } from 'yaml';
+/**
+ * Strip `//` line and slash-star block comments from JSONC, string-aware so a
+ * `//` or `/*` inside a JSON string is preserved. Whitespace-preserving (spans
+ * are blanked, not removed) so parser error offsets still line up with the
+ * source. Only used to validate — the original bytes are what gets written.
+ */
+export function stripJsonComments(input) {
+    let out = '';
+    let inString = false;
+    let escaped = false;
+    for (let i = 0; i < input.length; i++) {
+        const ch = input[i];
+        if (inString) {
+            out += ch;
+            if (escaped)
+                escaped = false;
+            else if (ch === '\\')
+                escaped = true;
+            else if (ch === '"')
+                inString = false;
+            continue;
+        }
+        if (ch === '"') {
+            inString = true;
+            out += ch;
+            continue;
+        }
+        if (ch === '/' && input[i + 1] === '/') {
+            // Line comment runs to EOL; nothing follows it on the line, so dropping the
+            // body doesn't shift any later token — only the newline must be preserved.
+            while (i < input.length && input[i] !== '\n')
+                i++;
+            out += input[i] === '\n' ? '\n' : '';
+            continue;
+        }
+        if (ch === '/' && input[i + 1] === '*') {
+            out += '  '; // the opening `/*`, blanked in place so same-line offsets after it hold
+            i += 2;
+            while (i < input.length && !(input[i] === '*' && input[i + 1] === '/')) {
+                out += input[i] === '\n' ? '\n' : ' ';
+                i++;
+            }
+            i++; // land on the closing '/'
+            out += '  '; // the closing `*/`
+            continue;
+        }
+        out += ch;
+    }
+    return out;
+}
+/** Validate `content` against `format`. Markdown is always valid; empty is always valid (a new file). */
+export function validateConfig(content, format) {
+    if (format === 'markdown')
+        return { ok: true };
+    if (content.trim() === '')
+        return { ok: true };
+    try {
+        switch (format) {
+            case 'json':
+                JSON.parse(content);
+                return { ok: true };
+            case 'jsonc':
+                JSON.parse(stripJsonComments(content));
+                return { ok: true };
+            case 'toml':
+                parseToml(content);
+                return { ok: true };
+            case 'yaml':
+                // `parse` throws on the first error (duplicate keys and unclosed flow collections included),
+                // where `parseDocument` would collect them silently.
+                parseYaml(content);
+                return { ok: true };
+        }
+    }
+    catch (err) {
+        return { ok: false, error: err instanceof Error ? err.message : String(err) };
+    }
+    return { ok: true };
+}
+//# sourceMappingURL=validate.js.map

package/dist/agent-config/validate.js.map

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

package/dist/application-update/bin-recovery.d.ts

@@ -0,0 +1,5 @@
+/** Discovery already proved one of these two canonical global layouts. */
+export declare function windowsGlobalLayout(prefix: string, outerRoot: string, outerPackage: string): boolean;
+export declare function snapshotGlobalBins(directory: string, names: string[], windows: boolean, destination: string, assertOwned: () => Promise<void>): Promise<void>;
+/** Validate the entire private snapshot before touching any command path. */
+export declare function restoreGlobalBins(prefix: string, names: string[], windows: boolean, source: string, assertOwned: () => Promise<void>): Promise<void>;

package/dist/application-update/bin-recovery.js

@@ -0,0 +1,96 @@
+import { chmod, lstat, readFile, readlink, rm, symlink, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+const validName = (name) => typeof name === 'string' && /^[a-zA-Z0-9-]+$/.test(name);
+const fail = () => { throw new Error('invalid recovery command snapshot'); };
+/** Discovery already proved one of these two canonical global layouts. */
+export function windowsGlobalLayout(prefix, outerRoot, outerPackage) {
+    return outerRoot === join(prefix, 'node_modules', outerPackage);
+}
+function filenames(names, windows) {
+    if (!names.every(validName))
+        fail();
+    return names.flatMap(name => windows ? [name, `${name}.cmd`, `${name}.ps1`] : [name]);
+}
+export async function snapshotGlobalBins(directory, names, windows, destination, assertOwned) {
+    const entries = [];
+    for (const name of filenames(names, windows)) {
+        await assertOwned();
+        const path = join(directory, name);
+        const info = await lstat(path).catch((error) => {
+            if (error.code === 'ENOENT')
+                return undefined;
+            throw error; // Permission and I/O failures must not become "absent".
+        });
+        if (!info)
+            entries.push({ name, kind: 'absent' });
+        else if (info.isSymbolicLink())
+            entries.push({ name, kind: 'link', target: await readlink(path) });
+        else if (info.isFile())
+            entries.push({ name, kind: 'file', bytes: (await readFile(path)).toString('base64'), mode: info.mode & 0o777 });
+        else
+            throw new Error('unsupported npm command file');
+    }
+    await assertOwned();
+    await writeFile(destination, JSON.stringify({ version: 1, windows, entries }), { mode: 0o600 });
+}
+/** Validate the entire private snapshot before touching any command path. */
+export async function restoreGlobalBins(prefix, names, windows, source, assertOwned) {
+    const raw = JSON.parse(await readFile(source, 'utf8'));
+    const allowed = new Set(filenames(names, windows));
+    let entries;
+    // Keep already-prepared POSIX updates resumable across this change.
+    if (Array.isArray(raw)) {
+        if (windows)
+            fail();
+        entries = raw.map((link) => {
+            if (!link || typeof link !== 'object')
+                return fail();
+            const item = link;
+            if (!allowed.has(item.name) || typeof item.target !== 'string')
+                return fail();
+            return { name: item.name, kind: 'link', target: item.target };
+        });
+    }
+    else {
+        if (!raw || typeof raw !== 'object')
+            fail();
+        const snapshot = raw;
+        if (snapshot.version !== 1 || snapshot.windows !== windows || !Array.isArray(snapshot.entries))
+            fail();
+        const seen = new Set();
+        entries = snapshot.entries.map((value) => {
+            if (!value || typeof value !== 'object')
+                return fail();
+            const entry = value;
+            if (typeof entry.name !== 'string' || !allowed.has(entry.name) || seen.has(entry.name))
+                return fail();
+            seen.add(entry.name);
+            if (entry.kind === 'absent')
+                return { name: entry.name, kind: 'absent' };
+            if (entry.kind === 'link' && typeof entry.target === 'string' && !entry.target.includes('\0')) {
+                return { name: entry.name, kind: 'link', target: entry.target };
+            }
+            if (entry.kind === 'file' && typeof entry.bytes === 'string' && Buffer.from(entry.bytes, 'base64').toString('base64') === entry.bytes
+                && typeof entry.mode === 'number' && Number.isInteger(entry.mode) && entry.mode >= 0 && entry.mode <= 0o777) {
+                return { name: entry.name, kind: 'file', bytes: entry.bytes, mode: entry.mode };
+            }
+            return fail();
+        });
+        if (seen.size !== allowed.size)
+            fail();
+    }
+    const directory = windows ? prefix : join(prefix, 'bin');
+    for (const entry of entries) {
+        await assertOwned();
+        const path = join(directory, entry.name);
+        await rm(path, { force: true }); // Do not follow replaced symlinks or remove directories.
+        await assertOwned();
+        if (entry.kind === 'link')
+            await symlink(entry.target, path);
+        if (entry.kind === 'file') {
+            await writeFile(path, Buffer.from(entry.bytes, 'base64'), { mode: entry.mode, flag: 'wx' });
+            await chmod(path, entry.mode);
+        }
+    }
+}
+//# sourceMappingURL=bin-recovery.js.map

package/dist/application-update/bin-recovery.js.map

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

package/dist/application-update/discovery.d.ts

@@ -0,0 +1,23 @@
+import { type NpmLaunchPackage } from '../home/identity.ts';
+export type Installation = {
+    kind: 'unsupported';
+    reason: string;
+} | {
+    kind: 'global' | 'npx';
+    prefix: string;
+    cache: string;
+    installRoot: string;
+    packageRoot: string;
+    outerRoot: string;
+    launchEntry: string;
+    outerPackage: NpmLaunchPackage;
+    request: string;
+};
+export interface DiscoveryInput {
+    prefix: string;
+    cache: string;
+    packageRoot: string;
+    launchEntry: string;
+}
+/** Match only npm-owned, canonical layouts. A matched but unsafe layout is explicit. */
+export declare function discoverInstallation(input: DiscoveryInput, rebrand?: boolean): Installation;

package/dist/application-update/discovery.js

@@ -0,0 +1,131 @@
+import { npmPackageIdentity, productIdentity } from '../home/identity.js';
+import { installedRuntime } from './runtime-layout.js';
+import { realpathSync, readFileSync } from 'node:fs';
+import { join, relative, resolve, sep } from 'node:path';
+function inside(path, root) {
+    const rel = relative(root, path);
+    return rel === '' || (rel !== '..' && !rel.startsWith(`..${sep}`) && !rel.startsWith(sep));
+}
+function json(path) {
+    return JSON.parse(readFileSync(path, 'utf8'));
+}
+function unsupported(reason) {
+    return { kind: 'unsupported', reason };
+}
+function discoverInstallLayout(input, rebrand) {
+    let prefix;
+    try {
+        prefix = realpathSync(input.prefix);
+    }
+    catch {
+        prefix = resolve(input.prefix);
+    }
+    // A fresh global npm install need not have created its cache yet.
+    let cache;
+    try {
+        cache = realpathSync(input.cache);
+    }
+    catch {
+        cache = resolve(input.cache);
+    }
+    const packageRoot = realpathSync(input.packageRoot);
+    const launchEntry = realpathSync(input.launchEntry);
+    const manifest = json(join(packageRoot, 'package.json'));
+    const identity = typeof manifest.name === 'string' ? npmPackageIdentity(manifest.name) : undefined;
+    if (!identity || identity.npmPackage !== manifest.name || (identity.rebrand && !rebrand) || typeof manifest.version !== 'string') {
+        return unsupported('running package is not @wjarka/cezarion');
+    }
+    if (inside(packageRoot, join(prefix, 'lib/node_modules')) || inside(packageRoot, join(prefix, 'node_modules'))) {
+        return {
+            kind: 'global', prefix, cache, packageRoot, launchEntry, installRoot: prefix, identity,
+            modules: inside(packageRoot, join(prefix, 'lib/node_modules')) ? join(prefix, 'lib/node_modules') : join(prefix, 'node_modules'),
+        };
+    }
+    const parts = relative(cache, packageRoot).split(sep);
+    if (parts[0] !== '_npx' || !/^[a-z0-9]+$/i.test(parts[1] ?? '') || parts[2] !== 'node_modules') {
+        return unsupported('not an npm global or npx cache installation');
+    }
+    const installRoot = join(cache, '_npx', parts[1]);
+    return { kind: 'npx', prefix, cache, packageRoot, launchEntry, installRoot, identity, modules: join(installRoot, 'node_modules') };
+}
+function discoverNpxRequest(installRoot, identity) {
+    const root = json(join(installRoot, 'package.json'));
+    const requests = root._npx?.packages;
+    if (!Array.isArray(requests) || requests.length !== 1 ||
+        ![identity.npmAlias, identity.npmPackage].includes(requests[0])) {
+        return unsupported('pinned or mixed npx request');
+    }
+    return requests[0];
+}
+function discoverOuterPackage(layout, launchPath) {
+    const { prefix, cache, packageRoot, launchEntry, kind, installRoot, modules, identity } = layout;
+    const direct = join(modules, identity.npmPackage);
+    const alias = join(modules, identity.npmAlias);
+    if (packageRoot !== direct && packageRoot !== join(alias, 'node_modules', identity.npmPackage)) {
+        return unsupported('linked or mixed package layout');
+    }
+    let outerPackage = inside(launchEntry, alias) ? identity.npmAlias : identity.npmPackage;
+    let request = outerPackage;
+    if (kind === 'npx') {
+        const npxRequest = discoverNpxRequest(installRoot, identity);
+        if (typeof npxRequest !== 'string')
+            return npxRequest;
+        request = npxRequest;
+        // npm may link .bin/cezarion to the scoped dependency even when the _npx
+        // request and root dependency are the alias. Metadata owns this choice.
+        outerPackage = request;
+    }
+    if (outerPackage === identity.npmPackage && packageRoot !== direct)
+        return unsupported('mixed launch layout');
+    const outerPath = outerPackage === identity.npmAlias ? alias : direct;
+    if (!inside(launchEntry, outerPath) && !(kind === 'npx' && inside(launchEntry, packageRoot))) {
+        return unsupported('launch entry does not belong to installation');
+    }
+    if (outerPackage === identity.npmAlias) {
+        const outer = json(join(alias, 'package.json'));
+        const deps = outer.dependencies;
+        if (outer.name !== identity.npmAlias || typeof deps?.[identity.npmPackage] !== 'string')
+            return unsupported('alias is not linked to scoped package');
+    }
+    return { kind, prefix, cache, installRoot, packageRoot, outerRoot: outerPath,
+        launchEntry: resolve(launchPath), outerPackage, request };
+}
+function discoverForwardingPackage(layout, launchPath) {
+    if (!layout.identity.rebrand)
+        return undefined;
+    const legacy = productIdentity(false);
+    let outerPackage;
+    if (layout.kind === 'npx') {
+        const request = discoverNpxRequest(layout.installRoot, legacy);
+        if (typeof request === 'string')
+            outerPackage = request;
+    }
+    else {
+        outerPackage = [legacy.npmPackage, legacy.npmAlias]
+            .find(name => inside(layout.launchEntry, join(layout.modules, name)));
+    }
+    if (!outerPackage)
+        return undefined;
+    const runtime = installedRuntime(layout.modules, outerPackage);
+    const outerRoot = join(layout.modules, outerPackage);
+    if (runtime.path !== layout.packageRoot || (!inside(layout.launchEntry, outerRoot)
+        && !(layout.kind === 'npx' && inside(layout.launchEntry, runtime.path)))) {
+        return unsupported('mixed forwarding layout');
+    }
+    return { kind: layout.kind, prefix: layout.prefix, cache: layout.cache, installRoot: layout.installRoot,
+        packageRoot: layout.packageRoot, outerRoot, outerPackage, request: outerPackage, launchEntry: resolve(launchPath) };
+}
+/** Match only npm-owned, canonical layouts. A matched but unsafe layout is explicit. */
+export function discoverInstallation(input, rebrand = productIdentity().rebrand) {
+    try {
+        const layout = discoverInstallLayout(input, rebrand);
+        if (layout.kind === 'unsupported')
+            return layout;
+        return (rebrand ? discoverForwardingPackage(layout, input.launchEntry) : undefined)
+            ?? discoverOuterPackage(layout, input.launchEntry);
+    }
+    catch {
+        return unsupported('installation metadata is unavailable');
+    }
+}
+//# sourceMappingURL=discovery.js.map

package/dist/application-update/discovery.js.map

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

package/dist/application-update/helper.d.ts

@@ -0,0 +1,58 @@
+import { type NpmLaunchPackage } from '../home/identity.js';
+import { type AddressInfo } from 'node:net';
+export interface HelperPlan {
+    installation: {
+        kind: 'global' | 'npx';
+        prefix: string;
+        cache: string;
+        installRoot: string;
+        packageRoot: string;
+        outerRoot: string;
+        launchEntry: string;
+        outerPackage: NpmLaunchPackage;
+        request: string;
+    };
+    targetVersion: string;
+    oldVersion: string;
+    recovery: string;
+    recoveryPackage?: string | undefined;
+    binLinks?: string | undefined;
+    recordPath: string;
+    oldPid: number;
+    nodeExecutable: string;
+    nodeArgs: string[];
+    cliArgs: string[];
+    cwd: string;
+    repoRoot: string;
+    host: string;
+    port: number;
+    npmBin: string;
+    claimId: string;
+}
+/** Only a listening TCP server can supply the private restart destination. */
+export declare function restartEndpoint(address: AddressInfo | string | null): Pick<HelperPlan, 'host' | 'port'>;
+export declare function restartHealthUrl(endpoint: Pick<HelperPlan, 'host' | 'port'>): string;
+/** A private loopback probe must not use Node's environment-proxied global agent. */
+export declare function requestRestartHealth(endpoint: Pick<HelperPlan, 'host' | 'port'>, signal: AbortSignal): Promise<{
+    version?: string;
+    repoRoot?: string;
+} | undefined>;
+export interface RestartIO {
+    waitForOldExit(): Promise<void>;
+    promote(): Promise<void>;
+    validateOriginal(): Promise<void>;
+    launch(): Promise<void>;
+    verifyHealth(): Promise<void>;
+    reapReplacement(): Promise<void>;
+    restore(): Promise<void>;
+    launchPrevious(): Promise<void>;
+    reportSuccess(): Promise<void>;
+    reportFailure(rollbackFailed: boolean, recoveryDetail?: string): Promise<void>;
+    assertOwned?(): Promise<void>;
+}
+/** Only the helper owns the promotion transaction. Rollback waits for its child to exit. */
+export declare function runRestartWorkflow(io: RestartIO): Promise<void>;
+export declare function manualRepairCommand(installation: Pick<HelperPlan['installation'], 'kind' | 'prefix' | 'installRoot' | 'outerPackage'>, version: string): string;
+export declare function promoteOriginal(plan: HelperPlan, npxLockAlreadyHeld?: boolean, signal?: AbortSignal): Promise<void>;
+export declare function restoreOriginal(plan: HelperPlan, assertOwned?: () => Promise<void>): Promise<void>;
+export declare function runHelper(plan: HelperPlan, onArmed?: () => void): Promise<void>;