@rryando/arcs 4.2.1 → 5.0.0

package/dist/utils/claude-code-hook-install.js

@@ -1,212 +0,0 @@
-/**
- * Consent-gated writer for the Claude Code session-bridge hook.
- *
- * `arcs hooks install-claude-code` deliberately never edits agent configuration
- * — it prints a snippet. This module is the opt-in counterpart: when the user
- * explicitly confirms during `arcs project init`, it merges the same hook entry
- * into the workspace's `.claude/settings.local.json` (local-only: the token is a
- * secret and `settings.local.json` is the git-ignored variant).
- *
- * Two rules the merge must never break:
- *   1. A malformed existing file ABORTS the write. Silently coalescing an
- *      unparseable settings file to `{}` would destroy a user's `permissions`
- *      block over a stray comma, so parse errors are surfaced, not swallowed.
- *   2. Replacement is keyed on the absolute hook script path, not the project
- *      slug. A workspace can be reassigned between ARCS projects, so matching on
- *      the script path leaves exactly one current ARCS entry per event instead
- *      of accumulating stale ones. Entries belonging to other tools are kept
- *      untouched, in place.
- */
-import { chmod, mkdir, readFile, writeFile } from "node:fs/promises";
-import { dirname, join } from "node:path";
-import * as p from "@clack/prompts";
-import color from "picocolors";
-import { HOOK_EVENTS, provisionHookCommand } from "../cli/commands/hooks.js";
-/** The only file this module ever writes — never `~/.claude/settings.json`. */
-export function claudeSettingsLocalPath(workspacePath) {
-    return join(workspacePath, ".claude", "settings.local.json");
-}
-/**
- * `chmod` that tolerates an absent file and nothing else.
- *
- * Used to narrow a settings file BEFORE it is rewritten, where "there is no
- * file yet" is the ordinary fresh-install outcome and not a failure — the
- * write's own `mode` covers that path. Every other errno (EPERM on a file this
- * user does not own, EROFS) means the mode of a token-bearing file is not ours
- * to set, so it propagates and fails the install closed, exactly as the
- * trailing chmod does.
- */
-async function chmodIfPresent(path, mode) {
-    try {
-        await chmod(path, mode);
-    }
-    catch (err) {
-        if (err?.code !== "ENOENT")
-            throw err;
-    }
-}
-/**
- * Returns a copy of `settings` with the ARCS hook entry registered under every
- * hook event, replacing any prior entry that runs the same `hookScriptPath`.
- * Pure — no I/O, so the merge rules are directly testable.
- */
-export function mergeHookIntoSettings(settings, hook) {
-    const hooks = { ...(settings.hooks ?? {}) };
-    for (const event of HOOK_EVENTS) {
-        const existing = Array.isArray(hooks[event]) ? hooks[event] : [];
-        const preserved = [];
-        for (const entry of existing) {
-            if (!entry || typeof entry !== "object" || !Array.isArray(entry.hooks)) {
-                // Not a shape we understand — leave it exactly as found.
-                preserved.push(entry);
-                continue;
-            }
-            // Strip only OUR command, at the inner level: a matcher entry may mix an
-            // ARCS hook with another tool's, and that other tool must survive.
-            const kept = entry.hooks.filter((h) => !(typeof h?.command === "string" && h.command.includes(hook.hookScriptPath)));
-            if (kept.length === 0)
-                continue;
-            preserved.push({ ...entry, hooks: kept });
-        }
-        preserved.push({ hooks: [{ type: "command", command: hook.command }] });
-        hooks[event] = preserved;
-    }
-    return { ...settings, hooks };
-}
-/**
- * Reads the workspace's `.claude/settings.local.json` (if any), merges in a
- * freshly provisioned hook, and writes it back owner-only.
- *
- * Throws when the existing file is present but unparseable — nothing is written
- * in that case, so a hand-edited settings file is never clobbered.
- */
-export async function installClaudeCodeHook(options) {
-    const settingsPath = claudeSettingsLocalPath(options.workspacePath);
-    let raw;
-    try {
-        raw = await readFile(settingsPath, "utf-8");
-    }
-    catch {
-        // Absent file — start from an empty settings object.
-    }
-    let settings = {};
-    if (raw !== undefined && raw.trim().length > 0) {
-        let parsed;
-        try {
-            parsed = JSON.parse(raw);
-        }
-        catch {
-            throw new Error(`${settingsPath} exists but is not valid JSON — fix it manually or delete it, ` +
-                `then re-run \`arcs hooks install-claude-code ${options.slug}\`. Nothing was written.`);
-        }
-        if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
-            throw new Error(`${settingsPath} is valid JSON but not an object — fix it manually or delete it, ` +
-                `then re-run \`arcs hooks install-claude-code ${options.slug}\`. Nothing was written.`);
-        }
-        settings = parsed;
-    }
-    const provisioned = await provisionHookCommand({
-        projectDir: options.projectDir,
-        slug: options.slug,
-        serverUrl: options.serverUrl,
-    });
-    const merged = mergeHookIntoSettings(settings, provisioned);
-    await mkdir(dirname(settingsPath), { recursive: true });
-    // The merged command embeds `ARCS_HOOK_TOKEN=<value>`, so this file is a
-    // SECOND cleartext copy of the hook token — this one in the user's repo
-    // rather than under ARCS's own data dir. It is narrowed in three steps
-    // because no one of them covers both the fresh and the repair path:
-    //
-    //   1. chmod BEFORE the write, best-effort. `writeFile` is a direct,
-    //      non-atomic open(path, "w", mode): when the file already exists the
-    //      `mode` argument is a no-op and the open merely truncates the inode
-    //      that is there, so without this step the freshly minted token would be
-    //      written into a still-0644 inode and sit world-readable for the write
-    //      plus an await hop. ENOENT is ignored (see chmodIfPresent) because on a
-    //      fresh install there is nothing to narrow yet. This runs AFTER the
-    //      strict parse above, so a file that aborts the install keeps its mode
-    //      as well as its bytes.
-    //   2. `mode` on the write itself. It applies only when the open CREATES the
-    //      inode — which is precisely the fresh path, where it means the inode is
-    //      0600 before the token's first byte reaches it and step 1 had nothing
-    //      to do. (That create-only caveat is exactly the one that does NOT apply
-    //      to the token store's temp+rename writer, where every write installs a
-    //      fresh inode — it bites squarely here.)
-    //   3. chmod after the write, unconditional. Steps 1 and 2 are each a claim
-    //      about how THIS writer behaves — one assumes the inode survives the
-    //      write, the other that the write creates it. Step 3 assumes nothing, so
-    //      "0600 when this function returns" is a postcondition rather than an
-    //      inference from the writer's syscalls.
-    //
-    // What this buys, stated honestly: 0o600 is a cross-user control. It does
-    // nothing against a process running as THIS user, and it does not hide the
-    // token from `ps` — the value is inlined in the hook command string, so every
-    // hook fire still exposes it in the process table. Handing the hook a path
-    // (`ARCS_HOOK_TOKEN_FILE=<path>`) instead of the value would close that; the
-    // mode only closes the on-disk half. Nor can any mode revoke a descriptor
-    // another account already opened on a 0644 file: the write edits that same
-    // inode in place, so such a reader follows the file into the new token. All
-    // three steps are a floor from this point forward, not a retraction of what
-    // was reachable before.
-    //
-    // The `.claude` DIRECTORY is deliberately left exactly as found. Unlike the
-    // hooks dir under ARCS's data dir, which holds nothing but the token, this
-    // one holds the user's other Claude Code files, and narrowing it would be a
-    // hostile surprise in a directory ARCS does not own.
-    await chmodIfPresent(settingsPath, 0o600);
-    await writeFile(settingsPath, `${JSON.stringify(merged, null, 2)}\n`, {
-        encoding: "utf-8",
-        mode: 0o600,
-    });
-    await chmod(settingsPath, 0o600);
-    return {
-        settingsPath,
-        token: provisioned.token,
-        hookScriptPath: provisioned.hookScriptPath,
-        serverUrl: provisioned.serverUrl,
-        events: [...HOOK_EVENTS],
-    };
-}
-/**
- * Interactively offers the hook install during `arcs project init`.
- *
- * Mirrors `promptAndInstallCodegraph`: a note explaining the offer, a confirm
- * defaulting to "no", and a manual-fallback hint when declined. Returns the
- * install result only when a write actually happened; returns `null` on
- * decline, cancel, or failure. Never throws — `arcs project init` succeeding
- * matters more than this offer succeeding.
- */
-export async function promptAndInstallClaudeCodeHook(options) {
-    const settingsPath = claudeSettingsLocalPath(options.workspacePath);
-    p.note([
-        "The session-bridge hook lets ARCS discover your Claude Code sessions,",
-        "stage project context at session start, and mirror transcripts — the",
-        "web UI drives work by forking a session into a new ARCS thread.",
-        "",
-        `Writes ${color.cyan(settingsPath)} only — never your global config.`,
-    ].join("\n"), "Optional: Claude Code session bridge");
-    const shouldInstall = await p.confirm({
-        message: "Install the Claude Code session-bridge hook now?",
-        initialValue: false,
-    });
-    if (p.isCancel(shouldInstall) || !shouldInstall) {
-        p.log.info(color.dim(`Install later:  arcs hooks install-claude-code ${options.slug}`));
-        return null;
-    }
-    try {
-        const result = await installClaudeCodeHook(options);
-        p.log.success([
-            `${color.green("✔")} Hook installed → ${color.cyan(result.settingsPath)}`,
-            color.dim("Start a NEW Claude Code session to pick it up — running sessions won't."),
-        ].join("\n"));
-        return result;
-    }
-    catch (err) {
-        p.log.warn([
-            `${color.yellow("⚠")} Could not install the hook: ${err instanceof Error ? err.message : String(err)}`,
-            color.dim(`Install manually later:  arcs hooks install-claude-code ${options.slug}`),
-        ].join("\n"));
-        return null;
-    }
-}
-//# sourceMappingURL=claude-code-hook-install.js.map

package/dist/utils/claude-code-hook-install.js.map

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

package/dist/utils/graphify-knowledge.d.ts

@@ -1,22 +0,0 @@
-import type { KnowledgeProposal } from "./graphify.js";
-/**
- * Convert graphify ingestion output into a `proposals/graphify.json` payload
- * and persist it through `proposal-store.writeProposals()`.
- *
- * Replaces the legacy direct-write path that used to populate
- * `knowledge/index.json` and `knowledge/<id>.md` at ingest time. Graphify
- * proposals now sit in the proposals gate until a skill-aware host enriches
- * them into durable knowledge entries.
- *
- * Merge semantics: if a proposals file already exists, proposals from the
- * existing file with ids NOT present in the new extraction are preserved.
- * This protects backfilled proposals (with empty structuralFacts) and any
- * other pending entries from being clobbered when graphify re-runs. The new
- * extraction wins on collisions — a fresh extraction produces fresher facts.
- */
-export declare function writeProposalsFile(slug: string, proposals: KnowledgeProposal[], graphJsonContent: string): Promise<{
-    written: number;
-    fingerprint: string;
-    preserved: number;
-}>;
-//# sourceMappingURL=graphify-knowledge.d.ts.map

package/dist/utils/graphify-knowledge.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"graphify-knowledge.d.ts","sourceRoot":"","sources":["../../src/utils/graphify-knowledge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAUvD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,iBAAiB,EAAE,EAC9B,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAmCtE"}

package/dist/utils/graphify-knowledge.js

@@ -1,47 +0,0 @@
-import { annotateDedupCandidates, computeGraphFingerprint, readProposals, writeProposals, } from "./proposal-store.js";
-/**
- * Convert graphify ingestion output into a `proposals/graphify.json` payload
- * and persist it through `proposal-store.writeProposals()`.
- *
- * Replaces the legacy direct-write path that used to populate
- * `knowledge/index.json` and `knowledge/<id>.md` at ingest time. Graphify
- * proposals now sit in the proposals gate until a skill-aware host enriches
- * them into durable knowledge entries.
- *
- * Merge semantics: if a proposals file already exists, proposals from the
- * existing file with ids NOT present in the new extraction are preserved.
- * This protects backfilled proposals (with empty structuralFacts) and any
- * other pending entries from being clobbered when graphify re-runs. The new
- * extraction wins on collisions — a fresh extraction produces fresher facts.
- */
-export async function writeProposalsFile(slug, proposals, graphJsonContent) {
-    // Map ingestion shape → storage shape. The storage `Proposal` adds an
-    // initially-empty `suggestedDedupCandidates`; `annotateDedupCandidates`
-    // populates it from the existing knowledge index.
-    const draft = proposals.map((p) => ({
-        id: p.id,
-        kind: p.kind,
-        label: p.label,
-        structuralFacts: p.structuralFacts,
-        sourceFiles: p.sourceFiles,
-        suggestedDedupCandidates: [],
-    }));
-    const annotated = await annotateDedupCandidates(slug, draft);
-    // Preserve existing proposals not present in the new extraction. This
-    // protects the lossy backfill payload (structuralFacts: {}) and any other
-    // pending agent-enrichment work from being silently dropped on the next
-    // graphify-sync. New extraction wins on id collisions.
-    const existing = await readProposals(slug);
-    const newIds = new Set(annotated.map((p) => p.id));
-    const preserved = existing ? existing.proposals.filter((p) => !newIds.has(p.id)) : [];
-    const fingerprint = computeGraphFingerprint(graphJsonContent);
-    const payload = {
-        version: 1,
-        generatedAt: new Date().toISOString(),
-        graphFingerprint: fingerprint,
-        proposals: [...annotated, ...preserved],
-    };
-    await writeProposals(slug, payload);
-    return { written: proposals.length, fingerprint, preserved: preserved.length };
-}
-//# sourceMappingURL=graphify-knowledge.js.map

package/dist/utils/graphify-knowledge.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"graphify-knowledge.js","sourceRoot":"","sources":["../../src/utils/graphify-knowledge.ts"],"names":[],"mappings":"AACA,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EAGvB,aAAa,EACb,cAAc,GACf,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAY,EACZ,SAA8B,EAC9B,gBAAwB;IAExB,sEAAsE;IACtE,wEAAwE;IACxE,kDAAkD;IAClD,MAAM,KAAK,GAAe,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9C,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,eAAe,EAAE,CAAC,CAAC,eAAqD;QACxE,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,wBAAwB,EAAE,EAAE;KAC7B,CAAC,CAAC,CAAC;IAEJ,MAAM,SAAS,GAAG,MAAM,uBAAuB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAE7D,sEAAsE;IACtE,0EAA0E;IAC1E,wEAAwE;IACxE,uDAAuD;IACvD,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEtF,MAAM,WAAW,GAAG,uBAAuB,CAAC,gBAAgB,CAAC,CAAC;IAE9D,MAAM,OAAO,GAAkB;QAC7B,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,gBAAgB,EAAE,WAAW;QAC7B,SAAS,EAAE,CAAC,GAAG,SAAS,EAAE,GAAG,SAAS,CAAC;KACxC,CAAC;IAEF,MAAM,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAEpC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC;AACjF,CAAC"}

package/dist/utils/graphify.d.ts

@@ -1,104 +0,0 @@
-export interface GraphifyInfo {
-    available: boolean;
-    version?: string;
-    path?: string;
-}
-export declare function detectGraphify(): GraphifyInfo;
-export interface ExtractionResult {
-    success: true;
-    graphJsonPath: string;
-}
-export interface ExtractionError {
-    success: false;
-    error: string;
-    code?: string;
-}
-export type ExtractionOutcome = ExtractionResult | ExtractionError;
-/**
- * A graphify-derived knowledge proposal.
- *
- * Carries STRUCTURAL FACTS only — not prose. The calling agent (which has LLM
- * tokens) is responsible for producing the final `title`/`summary`/`keywords`
- * during the proposal-promote step. See plan
- * `2026-06-02-graphify-proposal-gate-implementation-plan` §Proposal Shape.
- *
- * `suggestedDedupCandidates` is intentionally NOT on this type — that's
- * computed by the proposal-store layer when proposals are written to disk,
- * not at ingest time.
- */
-export interface KnowledgeProposal {
-    /** Stable id, e.g. "graphify-cluster-src-utils". */
-    id: string;
-    kind: "architecture" | "module" | "gotcha" | "pattern";
-    /** Human-friendly label. Agents will write the final title. */
-    label: string;
-    structuralFacts: ProposalStructuralFacts;
-    sourceFiles: Array<{
-        path: string;
-        anchor?: string;
-    }>;
-}
-export interface ProposalStructuralFacts {
-    memberCount?: number;
-    fileCount?: number;
-    /** e.g. { code: 260, document: 0 } */
-    fileTypeBreakdown?: Record<string, number>;
-    topHubs?: Array<{
-        label: string;
-        file: string;
-        in: number;
-        out: number;
-    }>;
-    topFilesByEntityCount?: Array<{
-        file: string;
-        count: number;
-    }>;
-    incomingFromOtherClusters?: number;
-    outgoingToOtherClusters?: number;
-    nodeFile?: string;
-    nodeIn?: number;
-    nodeOut?: number;
-    topCallers?: Array<{
-        label: string;
-        file: string;
-    }>;
-    topCallees?: Array<{
-        label: string;
-        file: string;
-    }>;
-    couplingA?: {
-        label: string;
-        file: string;
-        degree: number;
-    };
-    couplingB?: {
-        label: string;
-        file: string;
-        degree: number;
-    };
-    /** Edge relation types (e.g. ["imports_from", "calls"]). */
-    relations?: string[];
-}
-export interface IngestionResult {
-    proposals: KnowledgeProposal[];
-    stats: {
-        godNodes: number;
-        communities: number;
-        crossModuleCouplings: number;
-        totalProposals: number;
-    };
-}
-export declare function ingestGraph(graphJsonPath: string, _slug: string): IngestionResult;
-export interface QueryResult {
-    success: true;
-    answer: string;
-}
-export interface QueryError {
-    success: false;
-    error: string;
-}
-export type QueryOutcome = QueryResult | QueryError;
-export declare function queryGraph(question: string, workspacePath: string): QueryOutcome;
-export declare function pathBetween(entityA: string, entityB: string, workspacePath: string): QueryOutcome;
-export declare function runExtraction(workspacePath: string): ExtractionOutcome;
-//# sourceMappingURL=graphify.d.ts.map

package/dist/utils/graphify.d.ts.map

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