@rasensio/aidlc 1.4.0 → 1.6.0

package/dist/concurrency/claim-store.js

@@ -0,0 +1,273 @@
+/**
+ * Claim store: live instance claims in the git common dir (AC-1…AC-6).
+ *
+ * One YAML file per instance under `<common-dir>/aidlc/claims/` (design
+ * DD2): per-file writes need no cross-instance locking and unlink is an
+ * atomic release. Write discipline is read-check-write-recheck-rename
+ * (NFR-2); the residual TOCTOU window is accepted — claims are advisory
+ * coordination, not mutual exclusion.
+ *
+ * Legacy migration (AC-4, AC-23): a non-null `claim:` in instance.yaml is
+ * moved into the store on first read; on conflict the common-dir claim
+ * wins ("common-dir precedence" — the new store is authoritative once
+ * populated). instance.yaml always ends with `claim: null`.
+ *
+ * Outside a git repo (AC-5) or with an unwritable common dir (AC-27) the
+ * legacy instance.yaml path keeps working via `openClaimStore` returning
+ * a store backed by instance.yaml.
+ */
+import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, unlinkSync, writeFileSync, } from 'node:fs';
+import { join } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { loadYaml, saveYaml, serializeYaml } from '../state/yaml-helpers.js';
+import { coordinationRoot } from './common-dir.js';
+const INSTANCE_NAME_RE = /^[a-z0-9][a-z0-9-]*$/;
+/** Thrown when a write would override another session's live claim (AC-6). */
+export class ClaimConflictError extends Error {
+    instance;
+    holder;
+    constructor(instance, holder) {
+        super(`${instance} is claimed by session ${holder} (not stale)`);
+        this.instance = instance;
+        this.holder = holder;
+        this.name = 'ClaimConflictError';
+    }
+}
+export function isStale(claim, timeoutMinutes, now = new Date()) {
+    const last = Date.parse(claim.renewed_at ?? claim.claimed_at);
+    return now.getTime() - last >= timeoutMinutes * 60_000;
+}
+function isClaim(v) {
+    if (typeof v !== 'object' || v === null)
+        return false;
+    const r = v;
+    return (typeof r.session === 'string' &&
+        typeof r.claimed_at === 'string' &&
+        !Number.isNaN(Date.parse(r.claimed_at)) &&
+        (r.id_source === 'platform' || r.id_source === 'agent'));
+}
+class CommonDirStore {
+    claimsDir;
+    projectRoot;
+    timeoutMinutes;
+    kind = 'common-dir';
+    constructor(claimsDir, projectRoot, timeoutMinutes) {
+        this.claimsDir = claimsDir;
+        this.projectRoot = projectRoot;
+        this.timeoutMinutes = timeoutMinutes;
+    }
+    claimPath(instance) {
+        if (!INSTANCE_NAME_RE.test(instance))
+            throw new Error(`invalid instance name: ${instance}`);
+        return join(this.claimsDir, `${instance}.yaml`);
+    }
+    instanceYamlPath(instance) {
+        return join(this.projectRoot, '.aidlc', 'state', instance, 'instance.yaml');
+    }
+    readFile(instance) {
+        try {
+            const data = parseYaml(readFileSync(this.claimPath(instance), 'utf8'));
+            return isClaim(data) ? data : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Migrate a legacy instance.yaml `claim:` into the store (AC-4, AC-23).
+     * Idempotent; instance.yaml ends with `claim: null` in every path.
+     */
+    migrateLegacy(instance) {
+        const yamlPath = this.instanceYamlPath(instance);
+        if (!existsSync(yamlPath))
+            return;
+        let state;
+        try {
+            state = loadYaml(yamlPath);
+        }
+        catch {
+            return;
+        }
+        if (!state.claim)
+            return;
+        const legacy = {
+            session: state.claim.session,
+            claimed_at: state.claim.claimed_at,
+            ...(state.claim.renewed_at ? { renewed_at: state.claim.renewed_at } : {}),
+            id_source: state.claim.session.startsWith('agent-') ? 'agent' : 'platform',
+        };
+        const existing = this.readFile(instance);
+        // Common-dir precedence: an existing non-stale claim wins; the legacy
+        // claim is discarded without a session event (its winner already logged one).
+        if (!(existing && !isStale(existing, this.timeoutMinutes)) && !isStale(legacy, this.timeoutMinutes)) {
+            this.atomicWrite(instance, legacy);
+        }
+        state.claim = null;
+        saveYaml(yamlPath, state);
+    }
+    atomicWrite(instance, claim) {
+        mkdirSync(this.claimsDir, { recursive: true });
+        const target = this.claimPath(instance);
+        const tmp = `${target}.tmp.${process.pid}`;
+        writeFileSync(tmp, serializeYaml(claim), 'utf8');
+        renameSync(tmp, target);
+    }
+    read(instance) {
+        this.migrateLegacy(instance);
+        return this.readFile(instance);
+    }
+    write(instance, claim, opts = {}) {
+        // read-check-write-recheck-rename (NFR-2)
+        const check = () => {
+            const current = this.read(instance);
+            if (current &&
+                current.session !== claim.session &&
+                !isStale(current, this.timeoutMinutes) &&
+                !opts.override) {
+                throw new ClaimConflictError(instance, current.session);
+            }
+        };
+        check();
+        mkdirSync(this.claimsDir, { recursive: true });
+        const target = this.claimPath(instance);
+        const tmp = `${target}.tmp.${process.pid}`;
+        writeFileSync(tmp, serializeYaml(claim), 'utf8');
+        try {
+            check();
+        }
+        catch (err) {
+            unlinkSync(tmp);
+            throw err;
+        }
+        renameSync(tmp, target);
+    }
+    release(instance) {
+        this.migrateLegacy(instance);
+        try {
+            unlinkSync(this.claimPath(instance));
+        }
+        catch (err) {
+            if (err.code !== 'ENOENT')
+                throw err;
+        }
+    }
+    list() {
+        const out = new Map();
+        let files;
+        try {
+            files = readdirSync(this.claimsDir);
+        }
+        catch {
+            return out;
+        }
+        for (const f of files) {
+            if (!f.endsWith('.yaml'))
+                continue;
+            const instance = f.slice(0, -'.yaml'.length);
+            const claim = this.readFile(instance);
+            if (claim)
+                out.set(instance, claim);
+        }
+        return out;
+    }
+}
+// ---------------------------------------------------------------------------
+// Legacy store (non-git projects / unwritable common dir)
+// ---------------------------------------------------------------------------
+class LegacyStore {
+    projectRoot;
+    timeoutMinutes;
+    kind = 'legacy';
+    constructor(projectRoot, timeoutMinutes) {
+        this.projectRoot = projectRoot;
+        this.timeoutMinutes = timeoutMinutes;
+    }
+    instanceYamlPath(instance) {
+        return join(this.projectRoot, '.aidlc', 'state', instance, 'instance.yaml');
+    }
+    read(instance) {
+        let state;
+        try {
+            state = loadYaml(this.instanceYamlPath(instance));
+        }
+        catch {
+            return null;
+        }
+        if (!state.claim)
+            return null;
+        return {
+            session: state.claim.session,
+            claimed_at: state.claim.claimed_at,
+            ...(state.claim.renewed_at ? { renewed_at: state.claim.renewed_at } : {}),
+            id_source: state.claim.session.startsWith('agent-') ? 'agent' : 'platform',
+        };
+    }
+    write(instance, claim, opts = {}) {
+        const yamlPath = this.instanceYamlPath(instance);
+        const state = loadYaml(yamlPath);
+        if (state.claim &&
+            state.claim.session !== claim.session &&
+            !isStale(this.read(instance), this.timeoutMinutes) &&
+            !opts.override) {
+            throw new ClaimConflictError(instance, state.claim.session);
+        }
+        state.claim = {
+            session: claim.session,
+            claimed_at: claim.claimed_at,
+            ...(claim.renewed_at ? { renewed_at: claim.renewed_at } : {}),
+        };
+        saveYaml(yamlPath, state);
+    }
+    release(instance) {
+        const yamlPath = this.instanceYamlPath(instance);
+        let state;
+        try {
+            state = loadYaml(yamlPath);
+        }
+        catch {
+            return;
+        }
+        if (!state.claim)
+            return;
+        state.claim = null;
+        saveYaml(yamlPath, state);
+    }
+    list() {
+        const out = new Map();
+        const stateDir = join(this.projectRoot, '.aidlc', 'state');
+        let names;
+        try {
+            names = readdirSync(stateDir);
+        }
+        catch {
+            return out;
+        }
+        for (const name of names) {
+            const claim = this.read(name);
+            if (claim)
+                out.set(name, claim);
+        }
+        return out;
+    }
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+let warned = false;
+/**
+ * Open the claim store for a project. Common-dir backed inside a writable
+ * git repo; legacy instance.yaml backed otherwise (AC-5, AC-27) with a
+ * one-time warning.
+ */
+export function openClaimStore(projectRoot, timeoutMinutes) {
+    const root = coordinationRoot(projectRoot);
+    if (root !== null) {
+        return new CommonDirStore(join(root, 'claims'), projectRoot, timeoutMinutes);
+    }
+    if (!warned) {
+        warned = true;
+        process.stderr.write('aidlc: git common dir unavailable or unwritable — claims fall back to instance.yaml\n');
+    }
+    return new LegacyStore(projectRoot, timeoutMinutes);
+}
+//# sourceMappingURL=claim-store.js.map

package/dist/concurrency/claim-store.js.map

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

package/dist/concurrency/common-dir.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Git common-dir resolution shared by claim store and registry.
+ *
+ * All worktrees of a repository share one common dir (the primary
+ * checkout's `.git`); coordination data placed under
+ * `<common-dir>/aidlc/` is therefore visible from every worktree (AC-2).
+ *
+ * Extracted from cost/sessions.ts `repoIdentity` so both modules use one
+ * resolution path (design DD1).
+ */
+/**
+ * Resolve the git common dir for `cwd`, or null outside a git repo (AC-5).
+ * Symlink-normalized (realpath) so the same dir compares equal regardless
+ * of the path it was reached through (e.g. macOS /var → /private/var).
+ */
+export declare function gitCommonDir(cwd: string): string | null;
+/**
+ * Resolve the writable coordination root `<common-dir>/aidlc/`, creating it
+ * on first use. Returns null outside a git repo (AC-5) or when the common
+ * dir is not writable (AC-27) — callers fall back to legacy behavior.
+ */
+export declare function coordinationRoot(cwd: string): string | null;
+/** True when `cwd` is inside a linked worktree (not the primary checkout). */
+export declare function isLinkedWorktree(cwd: string): boolean;
+//# sourceMappingURL=common-dir.d.ts.map

package/dist/concurrency/common-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common-dir.d.ts","sourceRoot":"","sources":["../../src/concurrency/common-dir.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgBvD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAW3D;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAmBrD"}

package/dist/concurrency/common-dir.js

@@ -0,0 +1,81 @@
+/**
+ * Git common-dir resolution shared by claim store and registry.
+ *
+ * All worktrees of a repository share one common dir (the primary
+ * checkout's `.git`); coordination data placed under
+ * `<common-dir>/aidlc/` is therefore visible from every worktree (AC-2).
+ *
+ * Extracted from cost/sessions.ts `repoIdentity` so both modules use one
+ * resolution path (design DD1).
+ */
+import { accessSync, constants, existsSync, mkdirSync, realpathSync } from 'node:fs';
+import { isAbsolute, join, resolve } from 'node:path';
+import { execFileSync } from 'node:child_process';
+/**
+ * Resolve the git common dir for `cwd`, or null outside a git repo (AC-5).
+ * Symlink-normalized (realpath) so the same dir compares equal regardless
+ * of the path it was reached through (e.g. macOS /var → /private/var).
+ */
+export function gitCommonDir(cwd) {
+    try {
+        const out = execFileSync('git', ['rev-parse', '--git-common-dir'], {
+            cwd,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+        const abs = isAbsolute(out) ? out : resolve(cwd, out);
+        try {
+            return realpathSync(abs);
+        }
+        catch {
+            return abs;
+        }
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Resolve the writable coordination root `<common-dir>/aidlc/`, creating it
+ * on first use. Returns null outside a git repo (AC-5) or when the common
+ * dir is not writable (AC-27) — callers fall back to legacy behavior.
+ */
+export function coordinationRoot(cwd) {
+    const common = gitCommonDir(cwd);
+    if (common === null)
+        return null;
+    const root = join(common, 'aidlc');
+    try {
+        mkdirSync(root, { recursive: true });
+        accessSync(root, constants.W_OK);
+        return root;
+    }
+    catch {
+        return null;
+    }
+}
+/** True when `cwd` is inside a linked worktree (not the primary checkout). */
+export function isLinkedWorktree(cwd) {
+    const common = gitCommonDir(cwd);
+    if (common === null)
+        return false;
+    try {
+        const gitDir = execFileSync('git', ['rev-parse', '--git-dir'], {
+            cwd,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+        let absGitDir = isAbsolute(gitDir) ? gitDir : resolve(cwd, gitDir);
+        try {
+            absGitDir = realpathSync(absGitDir);
+        }
+        catch {
+            // keep resolved path
+        }
+        return absGitDir !== common && existsSync(absGitDir);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=common-dir.js.map

package/dist/concurrency/common-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common-dir.js","sourceRoot":"","sources":["../../src/concurrency/common-dir.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACrF,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,kBAAkB,CAAC,EAAE;YACjE,GAAG;YACH,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACtD,IAAI,CAAC;YACH,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC;QACH,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrC,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC,EAAE;YAC7D,GAAG;YACH,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACnE,IAAI,CAAC;YACH,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;QACD,OAAO,SAAS,KAAK,MAAM,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/concurrency/detect.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Concurrency detection: is another session working in this repository?
+ * (AC-7, AC-8, AC-12, AC-13, AC-14)
+ *
+ * Primary signal: another session's non-stale claim in the claim store.
+ * Pure reads — one directory listing plus YAML parses, no git subprocess
+ * on the hot path (NFR-1). Branch-pattern / dirty-tree corroboration is
+ * for reporting only and never blocks alone.
+ *
+ * Own-session exclusion (design F2): claims matching the resolved session
+ * id are excluded, as are claims recorded from this worktree's own path.
+ */
+import { type ClaimStore } from './claim-store.js';
+import { type ConcurrencyConfig, type Detection } from './types.js';
+/** Load the `concurrency:` block from `.aidlc/config.yaml` (AC-13). */
+export declare function loadConcurrencyConfig(projectRoot: string): ConcurrencyConfig;
+/**
+ * Detect other live sessions holding claims in this repository (AC-7).
+ * Staleness is `claim_timeout_minutes` — the one existing knob, no
+ * parallel threshold (idea decision 4).
+ */
+export declare function detectConcurrency(store: ClaimStore, ownSessionId: string, timeoutMinutes: number, projectRoot: string, now?: Date): Detection;
+//# sourceMappingURL=detect.d.ts.map

package/dist/concurrency/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/concurrency/detect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,EAAW,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAuB,KAAK,iBAAiB,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAEzF,uEAAuE;AACvE,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,CAqB5E;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,UAAU,EACjB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,EACnB,GAAG,GAAE,IAAiB,GACrB,SAAS,CAUX"}

package/dist/concurrency/detect.js

@@ -0,0 +1,59 @@
+/**
+ * Concurrency detection: is another session working in this repository?
+ * (AC-7, AC-8, AC-12, AC-13, AC-14)
+ *
+ * Primary signal: another session's non-stale claim in the claim store.
+ * Pure reads — one directory listing plus YAML parses, no git subprocess
+ * on the hot path (NFR-1). Branch-pattern / dirty-tree corroboration is
+ * for reporting only and never blocks alone.
+ *
+ * Own-session exclusion (design F2): claims matching the resolved session
+ * id are excluded, as are claims recorded from this worktree's own path.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { isStale } from './claim-store.js';
+import { DEFAULT_CONCURRENCY } from './types.js';
+/** Load the `concurrency:` block from `.aidlc/config.yaml` (AC-13). */
+export function loadConcurrencyConfig(projectRoot) {
+    const configPath = join(projectRoot, '.aidlc', 'config.yaml');
+    if (!existsSync(configPath))
+        return DEFAULT_CONCURRENCY;
+    try {
+        const config = parseYaml(readFileSync(configPath, 'utf8'));
+        const block = config?.concurrency;
+        if (!block)
+            return DEFAULT_CONCURRENCY;
+        const mode = block.mode === 'forbid' || block.mode === 'ask' || block.mode === 'offer-worktree'
+            ? block.mode
+            : DEFAULT_CONCURRENCY.mode;
+        const worktree_dir = typeof block.worktree_dir === 'string' && block.worktree_dir.trim() !== ''
+            ? block.worktree_dir
+            : DEFAULT_CONCURRENCY.worktree_dir;
+        return { mode, worktree_dir };
+    }
+    catch {
+        return DEFAULT_CONCURRENCY;
+    }
+}
+/**
+ * Detect other live sessions holding claims in this repository (AC-7).
+ * Staleness is `claim_timeout_minutes` — the one existing knob, no
+ * parallel threshold (idea decision 4).
+ */
+export function detectConcurrency(store, ownSessionId, timeoutMinutes, projectRoot, now = new Date()) {
+    const holders = [];
+    const here = resolve(projectRoot);
+    for (const [instance, claim] of store.list()) {
+        if (claim.session === ownSessionId)
+            continue;
+        if (claim.worktree_path && resolve(claim.worktree_path) === here)
+            continue;
+        if (isStale(claim, timeoutMinutes, now))
+            continue;
+        holders.push({ instance, session: claim.session });
+    }
+    return { busy: holders.length > 0, holders };
+}
+//# sourceMappingURL=detect.js.map

package/dist/concurrency/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../src/concurrency/detect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAmB,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAA0C,MAAM,YAAY,CAAC;AAEzF,uEAAuE;AACvE,MAAM,UAAU,qBAAqB,CAAC,WAAmB;IACvD,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IAC9D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,mBAAmB,CAAC;IACxD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAEjD,CAAC;QACT,MAAM,KAAK,GAAG,MAAM,EAAE,WAAW,CAAC;QAClC,IAAI,CAAC,KAAK;YAAE,OAAO,mBAAmB,CAAC;QACvC,MAAM,IAAI,GACR,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB;YAChF,CAAC,CAAC,KAAK,CAAC,IAAI;YACZ,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC;QAC/B,MAAM,YAAY,GAChB,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ,IAAI,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE;YACxE,CAAC,CAAC,KAAK,CAAC,YAAY;YACpB,CAAC,CAAC,mBAAmB,CAAC,YAAY,CAAC;QACvC,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,mBAAmB,CAAC;IAC7B,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAiB,EACjB,YAAoB,EACpB,cAAsB,EACtB,WAAmB,EACnB,MAAY,IAAI,IAAI,EAAE;IAEtB,MAAM,OAAO,GAAyB,EAAE,CAAC;IACzC,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAClC,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QAC7C,IAAI,KAAK,CAAC,OAAO,KAAK,YAAY;YAAE,SAAS;QAC7C,IAAI,KAAK,CAAC,aAAa,IAAI,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,IAAI;YAAE,SAAS;QAC3E,IAAI,OAAO,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,CAAC;YAAE,SAAS;QAClD,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC;AAC/C,CAAC"}

package/dist/concurrency/gitattributes.d.ts

@@ -0,0 +1,23 @@
+/**
+ * .gitattributes installer for AIDLC NDJSON merge hygiene (AC-19).
+ *
+ * merge=union lets parallel branches append to the same session/cost/
+ * transition logs and merge without conflict. Duplicated lines from
+ * same-position appends are handled at read time by whole-line dedup
+ * (AC-20, design F7).
+ *
+ * Idempotent: exact-line match before append, never duplicates entries.
+ */
+export declare const MERGE_UNION_LINES: string[];
+/**
+ * Ensure the merge=union entries exist in the repo-root .gitattributes.
+ * Returns the lines actually added (empty when already installed).
+ */
+export declare function installGitattributes(projectRoot: string): string[];
+/**
+ * Whole-line NDJSON dedup (AC-20): merge=union duplicates are
+ * byte-identical, while distinct same-second events differ somewhere in
+ * the line — so line identity never false-dedups (design F7).
+ */
+export declare function dedupLines(lines: string[]): string[];
+//# sourceMappingURL=gitattributes.d.ts.map

package/dist/concurrency/gitattributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitattributes.d.ts","sourceRoot":"","sources":["../../src/concurrency/gitattributes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,eAAO,MAAM,iBAAiB,UAI7B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAqBlE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CASpD"}

package/dist/concurrency/gitattributes.js

@@ -0,0 +1,52 @@
+/**
+ * .gitattributes installer for AIDLC NDJSON merge hygiene (AC-19).
+ *
+ * merge=union lets parallel branches append to the same session/cost/
+ * transition logs and merge without conflict. Duplicated lines from
+ * same-position appends are handled at read time by whole-line dedup
+ * (AC-20, design F7).
+ *
+ * Idempotent: exact-line match before append, never duplicates entries.
+ */
+import { existsSync, readFileSync, appendFileSync } from 'node:fs';
+import { join } from 'node:path';
+export const MERGE_UNION_LINES = [
+    '.aidlc/state/**/sessions.ndjson merge=union',
+    '.aidlc/state/**/transitions.log merge=union',
+    '.aidlc/state/**/costs.ndjson merge=union',
+];
+/**
+ * Ensure the merge=union entries exist in the repo-root .gitattributes.
+ * Returns the lines actually added (empty when already installed).
+ */
+export function installGitattributes(projectRoot) {
+    const path = join(projectRoot, '.gitattributes');
+    const existing = existsSync(path)
+        ? new Set(readFileSync(path, 'utf8')
+            .split('\n')
+            .map((l) => l.trim()))
+        : new Set();
+    const missing = MERGE_UNION_LINES.filter((l) => !existing.has(l));
+    if (missing.length === 0)
+        return [];
+    const prefix = existsSync(path) && !readFileSync(path, 'utf8').endsWith('\n') ? '\n' : '';
+    appendFileSync(path, `${prefix}# AIDLC append-only logs merge cleanly across worktree branches\n${missing.join('\n')}\n`, 'utf8');
+    return missing;
+}
+/**
+ * Whole-line NDJSON dedup (AC-20): merge=union duplicates are
+ * byte-identical, while distinct same-second events differ somewhere in
+ * the line — so line identity never false-dedups (design F7).
+ */
+export function dedupLines(lines) {
+    const seen = new Set();
+    const out = [];
+    for (const line of lines) {
+        if (seen.has(line))
+            continue;
+        seen.add(line);
+        out.push(line);
+    }
+    return out;
+}
+//# sourceMappingURL=gitattributes.js.map

package/dist/concurrency/gitattributes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitattributes.js","sourceRoot":"","sources":["../../src/concurrency/gitattributes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,6CAA6C;IAC7C,6CAA6C;IAC7C,0CAA0C;CAC3C,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,WAAmB;IACtD,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC;QAC/B,CAAC,CAAC,IAAI,GAAG,CACL,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC;aACvB,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CACxB;QACH,CAAC,CAAC,IAAI,GAAG,EAAU,CAAC;IAEtB,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,MAAM,MAAM,GACV,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7E,cAAc,CACZ,IAAI,EACJ,GAAG,MAAM,oEAAoE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EACnG,MAAM,CACP,CAAC;IACF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,KAAe;IACxC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAC7B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/concurrency/registry.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Instance registry: cross-worktree instance existence (AC-15, AC-16,
+ * AC-24, AC-26).
+ *
+ * One YAML file per instance under `<common-dir>/aidlc/registry/`.
+ * Creation writes with flag 'wx' DIRECTLY on the final path — the atomic
+ * exactly-one-success arbiter for racing `aidlc start` calls (AC-24).
+ * This is the one deliberate exception to the temp-rename discipline:
+ * creation is a single write, and readers tolerate parse failures as
+ * absent, so there is no partial-read hazard.
+ *
+ * The registry is live coordination data, not durable identity (design
+ * F5): entries exist from creation until pruned or completed. A merged
+ * instance with no entry and no claim is "complete and inactive".
+ */
+import type { RegistryEntry } from './types.js';
+/** Thrown when a registry entry for the name already exists (AC-24). */
+export declare class RegistryConflictError extends Error {
+    readonly instance: string;
+    constructor(instance: string);
+}
+export interface PruneItem {
+    name: string;
+    reason: string;
+}
+export declare class Registry {
+    private readonly dir;
+    private readonly projectRoot;
+    constructor(dir: string, projectRoot: string);
+    private entryPath;
+    /** Register a new instance; fails atomically if it exists (AC-24). */
+    register(entry: RegistryEntry): void;
+    lookup(name: string): RegistryEntry | null;
+    list(): RegistryEntry[];
+    /** Remove an entry (AC-17 completion cleanup). Missing entry is a no-op. */
+    remove(name: string): void;
+    /** True when `branch` is merged into main (AC-26). */
+    private isMerged;
+    private branchExists;
+    /**
+     * Identify stale entries: worktree path gone AND branch merged or
+     * deleted (AC-16). Removal only happens here — explicit prune.
+     */
+    prune(): PruneItem[];
+}
+/** Open the registry, or null when no writable common dir exists (AC-27). */
+export declare function openRegistry(projectRoot: string): Registry | null;
+//# sourceMappingURL=registry.d.ts.map

package/dist/concurrency/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/concurrency/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAeH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhD,wEAAwE;AACxE,qBAAa,qBAAsB,SAAQ,KAAK;aAClB,QAAQ,EAAE,MAAM;gBAAhB,QAAQ,EAAE,MAAM;CAI7C;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAaD,qBAAa,QAAQ;IAEjB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,WAAW;gBADX,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM;IAGtC,OAAO,CAAC,SAAS;IAKjB,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAepC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAS1C,IAAI,IAAI,aAAa,EAAE;IAgBvB,4EAA4E;IAC5E,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQ1B,sDAAsD;IACtD,OAAO,CAAC,QAAQ;IAYhB,OAAO,CAAC,YAAY;IAYpB;;;OAGG;IACH,KAAK,IAAI,SAAS,EAAE;CAkBrB;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAIjE"}