@rasensio/aidlc 1.4.0 → 1.6.0

package/dist/concurrency/registry.js

@@ -0,0 +1,163 @@
+/**
+ * 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 { existsSync, mkdirSync, readFileSync, readdirSync, unlinkSync, writeFileSync, } from 'node:fs';
+import { join } from 'node:path';
+import { execFileSync } from 'node:child_process';
+import { parse as parseYaml } from 'yaml';
+import { 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 registry entry for the name already exists (AC-24). */
+export class RegistryConflictError extends Error {
+    instance;
+    constructor(instance) {
+        super(`instance '${instance}' already registered in this repository`);
+        this.instance = instance;
+        this.name = 'RegistryConflictError';
+    }
+}
+function isEntry(v) {
+    if (typeof v !== 'object' || v === null)
+        return false;
+    const r = v;
+    return (typeof r.name === 'string' &&
+        (typeof r.branch === 'string' || r.branch === null) &&
+        (typeof r.worktree_path === 'string' || r.worktree_path === null) &&
+        typeof r.created_at === 'string');
+}
+export class Registry {
+    dir;
+    projectRoot;
+    constructor(dir, projectRoot) {
+        this.dir = dir;
+        this.projectRoot = projectRoot;
+    }
+    entryPath(name) {
+        if (!INSTANCE_NAME_RE.test(name))
+            throw new Error(`invalid instance name: ${name}`);
+        return join(this.dir, `${name}.yaml`);
+    }
+    /** Register a new instance; fails atomically if it exists (AC-24). */
+    register(entry) {
+        mkdirSync(this.dir, { recursive: true });
+        try {
+            writeFileSync(this.entryPath(entry.name), serializeYaml(entry), {
+                encoding: 'utf8',
+                flag: 'wx',
+            });
+        }
+        catch (err) {
+            if (err.code === 'EEXIST') {
+                throw new RegistryConflictError(entry.name);
+            }
+            throw err;
+        }
+    }
+    lookup(name) {
+        try {
+            const data = parseYaml(readFileSync(this.entryPath(name), 'utf8'));
+            return isEntry(data) ? data : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    list() {
+        let files;
+        try {
+            files = readdirSync(this.dir);
+        }
+        catch {
+            return [];
+        }
+        const entries = [];
+        for (const f of files) {
+            if (!f.endsWith('.yaml'))
+                continue;
+            const entry = this.lookup(f.slice(0, -'.yaml'.length));
+            if (entry)
+                entries.push(entry);
+        }
+        return entries;
+    }
+    /** Remove an entry (AC-17 completion cleanup). Missing entry is a no-op. */
+    remove(name) {
+        try {
+            unlinkSync(this.entryPath(name));
+        }
+        catch (err) {
+            if (err.code !== 'ENOENT')
+                throw err;
+        }
+    }
+    /** True when `branch` is merged into main (AC-26). */
+    isMerged(branch) {
+        try {
+            execFileSync('git', ['merge-base', '--is-ancestor', branch, 'main'], {
+                cwd: this.projectRoot,
+                stdio: 'ignore',
+            });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    branchExists(branch) {
+        try {
+            execFileSync('git', ['show-ref', '--verify', '--quiet', `refs/heads/${branch}`], {
+                cwd: this.projectRoot,
+                stdio: 'ignore',
+            });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Identify stale entries: worktree path gone AND branch merged or
+     * deleted (AC-16). Removal only happens here — explicit prune.
+     */
+    prune() {
+        const removed = [];
+        for (const entry of this.list()) {
+            const worktreeGone = entry.worktree_path === null || !existsSync(entry.worktree_path);
+            if (!worktreeGone)
+                continue;
+            if (entry.branch === null)
+                continue; // no-code instances are pruned on completion only
+            const merged = this.isMerged(entry.branch);
+            const deleted = !this.branchExists(entry.branch);
+            if (merged || deleted) {
+                this.remove(entry.name);
+                removed.push({
+                    name: entry.name,
+                    reason: merged ? 'worktree gone, branch merged' : 'worktree gone, branch deleted',
+                });
+            }
+        }
+        return removed;
+    }
+}
+/** Open the registry, or null when no writable common dir exists (AC-27). */
+export function openRegistry(projectRoot) {
+    const root = coordinationRoot(projectRoot);
+    if (root === null)
+        return null;
+    return new Registry(join(root, 'registry'), projectRoot);
+}
+//# sourceMappingURL=registry.js.map

package/dist/concurrency/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/concurrency/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,UAAU,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EACX,UAAU,EACV,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGnD,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAEhD,wEAAwE;AACxE,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAClB;IAA5B,YAA4B,QAAgB;QAC1C,KAAK,CAAC,aAAa,QAAQ,yCAAyC,CAAC,CAAC;QAD5C,aAAQ,GAAR,QAAQ,CAAQ;QAE1C,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAOD,SAAS,OAAO,CAAC,CAAU;IACzB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,CAAC,GAAG,CAA4B,CAAC;IACvC,OAAO,CACL,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;QAC1B,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC;QACnD,CAAC,OAAO,CAAC,CAAC,aAAa,KAAK,QAAQ,IAAI,CAAC,CAAC,aAAa,KAAK,IAAI,CAAC;QACjE,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,CACjC,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,QAAQ;IAEA;IACA;IAFnB,YACmB,GAAW,EACX,WAAmB;QADnB,QAAG,GAAH,GAAG,CAAQ;QACX,gBAAW,GAAX,WAAW,CAAQ;IACnC,CAAC;IAEI,SAAS,CAAC,IAAY;QAC5B,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC;QACpF,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,sEAAsE;IACtE,QAAQ,CAAC,KAAoB;QAC3B,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC;YACH,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE;gBAC9D,QAAQ,EAAE,MAAM;gBAChB,IAAI,EAAE,IAAI;aACX,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACrD,MAAM,IAAI,qBAAqB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC9C,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,MAAM,CAAC,IAAY;QACjB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAY,CAAC;YAC9E,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,IAAI;QACF,IAAI,KAAe,CAAC;QACpB,IAAI,CAAC;YACH,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,OAAO,GAAoB,EAAE,CAAC;QACpC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,SAAS;YACnC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;YACvD,IAAI,KAAK;gBAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,4EAA4E;IAC5E,MAAM,CAAC,IAAY;QACjB,IAAI,CAAC;YACH,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,GAAG,CAAC;QAClE,CAAC;IACH,CAAC;IAED,sDAAsD;IAC9C,QAAQ,CAAC,MAAc;QAC7B,IAAI,CAAC;YACH,YAAY,CAAC,KAAK,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;gBACnE,GAAG,EAAE,IAAI,CAAC,WAAW;gBACrB,KAAK,EAAE,QAAQ;aAChB,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,MAAc;QACjC,IAAI,CAAC;YACH,YAAY,CAAC,KAAK,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,MAAM,EAAE,CAAC,EAAE;gBAC/E,GAAG,EAAE,IAAI,CAAC,WAAW;gBACrB,KAAK,EAAE,QAAQ;aAChB,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,MAAM,OAAO,GAAgB,EAAE,CAAC;QAChC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAChC,MAAM,YAAY,GAAG,KAAK,CAAC,aAAa,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;YACtF,IAAI,CAAC,YAAY;gBAAE,SAAS;YAC5B,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI;gBAAE,SAAS,CAAC,kDAAkD;YACvF,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC3C,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACjD,IAAI,MAAM,IAAI,OAAO,EAAE,CAAC;gBACtB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACxB,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,+BAA+B;iBAClF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED,6EAA6E;AAC7E,MAAM,UAAU,YAAY,CAAC,WAAmB;IAC9C,MAAM,IAAI,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAC3C,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,WAAW,CAAC,CAAC;AAC3D,CAAC"}

package/dist/concurrency/session-id.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Stable session identity for concurrency detection (design F2).
+ *
+ * `resolveSession` in commands/claim.ts used to mint a fresh agent UUID
+ * per invocation, so a solo agent session could never recognize its own
+ * claim and would block itself. Resolution order here:
+ *
+ * 1. AIDLC_SESSION_ID env var — set once by the agent/skill at session
+ *    start, reused by every CLI invocation in that session.
+ * 2. Platform session from the active-session stash (strict
+ *    single-candidate rule, unchanged).
+ * 3. Process-lifetime cached agent UUID — stable within one process,
+ *    still fresh across processes (documented limitation for agents that
+ *    neither stash nor set the env var).
+ */
+export interface SessionIdentity {
+    id: string;
+    source: 'platform' | 'agent';
+    agent: string;
+}
+export declare function resolveSessionIdentity(projectRoot: string): SessionIdentity;
+//# sourceMappingURL=session-id.d.ts.map

package/dist/concurrency/session-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-id.d.ts","sourceRoot":"","sources":["../../src/concurrency/session-id.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;CACf;AAID,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,CAa3E"}

package/dist/concurrency/session-id.js

@@ -0,0 +1,35 @@
+/**
+ * Stable session identity for concurrency detection (design F2).
+ *
+ * `resolveSession` in commands/claim.ts used to mint a fresh agent UUID
+ * per invocation, so a solo agent session could never recognize its own
+ * claim and would block itself. Resolution order here:
+ *
+ * 1. AIDLC_SESSION_ID env var — set once by the agent/skill at session
+ *    start, reused by every CLI invocation in that session.
+ * 2. Platform session from the active-session stash (strict
+ *    single-candidate rule, unchanged).
+ * 3. Process-lifetime cached agent UUID — stable within one process,
+ *    still fresh across processes (documented limitation for agents that
+ *    neither stash nor set the env var).
+ */
+import { randomUUID } from 'node:crypto';
+import { resolveCurrentSession } from '../cost/sessions.js';
+let processAgentId = null;
+export function resolveSessionIdentity(projectRoot) {
+    const envId = process.env.AIDLC_SESSION_ID;
+    if (envId && envId.trim() !== '') {
+        return {
+            id: envId.trim(),
+            source: envId.trim().startsWith('agent-') ? 'agent' : 'platform',
+            agent: process.env.AIDLC_AGENT ?? 'unknown',
+        };
+    }
+    const active = resolveCurrentSession(projectRoot);
+    if (active)
+        return { id: active.session_id, source: 'platform', agent: active.agent };
+    if (processAgentId === null)
+        processAgentId = `agent-${randomUUID()}`;
+    return { id: processAgentId, source: 'agent', agent: process.env.AIDLC_AGENT ?? 'unknown' };
+}
+//# sourceMappingURL=session-id.js.map

package/dist/concurrency/session-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-id.js","sourceRoot":"","sources":["../../src/concurrency/session-id.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAQ5D,IAAI,cAAc,GAAkB,IAAI,CAAC;AAEzC,MAAM,UAAU,sBAAsB,CAAC,WAAmB;IACxD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAC3C,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACjC,OAAO;YACL,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE;YAChB,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU;YAChE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,SAAS;SAC5C,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,qBAAqB,CAAC,WAAW,CAAC,CAAC;IAClD,IAAI,MAAM;QAAE,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IACtF,IAAI,cAAc,KAAK,IAAI;QAAE,cAAc,GAAG,SAAS,UAAU,EAAE,EAAE,CAAC;IACtE,OAAO,EAAE,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,SAAS,EAAE,CAAC;AAC9F,CAAC"}

package/dist/concurrency/types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Shared types for the concurrency module (git-worktree instance).
+ *
+ * Coordination data lives in `<git-common-dir>/aidlc/` so every worktree
+ * of a repository sees the same claims and registry (AC-1, AC-2, AC-15).
+ * Durable artifacts stay tracked in git; only live coordination moves here.
+ */
+/** A live claim on an instance (AC-1). Stored per instance, never committed. */
+export interface Claim {
+    session: string;
+    claimed_at: string;
+    renewed_at?: string;
+    id_source: 'platform' | 'agent';
+    /** Set when the claiming session works in a linked worktree (AC-18b). */
+    worktree_path?: string;
+}
+/** A registry entry recording instance existence across worktrees (AC-26). */
+export interface RegistryEntry {
+    name: string;
+    /** Branch owning the instance; null for no-code instances (AC-11). */
+    branch: string | null;
+    worktree_path: string | null;
+    created_at: string;
+}
+/** Concurrency policy from `.aidlc/config.yaml` (AC-13). */
+export interface ConcurrencyConfig {
+    mode: 'offer-worktree' | 'forbid' | 'ask';
+    worktree_dir: string;
+}
+export declare const DEFAULT_CONCURRENCY: ConcurrencyConfig;
+/** Result of concurrency detection (AC-7). */
+export interface Detection {
+    busy: boolean;
+    holders: Array<{
+        instance: string;
+        session: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/concurrency/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,gFAAgF;AAChF,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,UAAU,GAAG,OAAO,CAAC;IAChC,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,8EAA8E;AAC9E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,4DAA4D;AAC5D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,gBAAgB,GAAG,QAAQ,GAAG,KAAK,CAAC;IAC1C,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,mBAAmB,EAAE,iBAGjC,CAAC;AAEF,8CAA8C;AAC9C,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvD"}

package/dist/concurrency/types.js

@@ -0,0 +1,12 @@
+/**
+ * Shared types for the concurrency module (git-worktree instance).
+ *
+ * Coordination data lives in `<git-common-dir>/aidlc/` so every worktree
+ * of a repository sees the same claims and registry (AC-1, AC-2, AC-15).
+ * Durable artifacts stay tracked in git; only live coordination moves here.
+ */
+export const DEFAULT_CONCURRENCY = {
+    mode: 'offer-worktree',
+    worktree_dir: '../',
+};
+//# sourceMappingURL=types.js.map

package/dist/concurrency/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/concurrency/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2BH,MAAM,CAAC,MAAM,mBAAmB,GAAsB;IACpD,IAAI,EAAE,gBAAgB;IACtB,YAAY,EAAE,KAAK;CACpB,CAAC"}

package/dist/concurrency/worktree.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Git worktree wrappers (AC-9, AC-10, AC-17, NFR-5).
+ *
+ * `createWorktree` creates branch + worktree in one step, always based on
+ * main, so an in-flight session in the primary checkout is never moved
+ * off its branch (idea goal 2). Callers export AIDLC_WORKTREE=1 before
+ * firing on-instance-start actions so the shipped branch action no-ops
+ * (AC-10).
+ *
+ * Removal order (AC-17, design F6): worktree remove FIRST — the claim is
+ * released only after removal succeeds, so a dirty worktree keeps its
+ * instance locked.
+ */
+/** Sanitize a path component to [a-z0-9-] (NFR-5). */
+export declare function sanitizeComponent(raw: string): string;
+export interface CreateWorktreeOpts {
+    prefix: string;
+    name: string;
+    worktreeDir: string;
+    projectRoot: string;
+    /** YYYYMMDD stamp; injectable for tests. */
+    dateStamp?: string;
+}
+export interface WorktreeRef {
+    branch: string;
+    path: string;
+}
+/**
+ * Create branch and worktree in one step, based on main (AC-9). Fails —
+ * never reuses — when the branch or target directory already exists (AC-24).
+ */
+export declare function createWorktree(opts: CreateWorktreeOpts): WorktreeRef;
+export interface RemoveReport {
+    removedWorktree: boolean;
+    deletedBranch: boolean;
+    reason?: string;
+}
+/**
+ * Remove a worktree and delete its branch iff merged into main (AC-17).
+ * A dirty worktree fails removal (no --force) and reports; the caller
+ * must NOT release the claim in that case (design F6).
+ */
+export declare function removeWorktree(ref: WorktreeRef, projectRoot: string): RemoveReport;
+/** List worktrees known to git (for status cross-checks, AC-18). */
+export declare function listWorktrees(projectRoot: string): Array<{
+    path: string;
+    branch: string | null;
+}>;
+//# sourceMappingURL=worktree.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../../src/concurrency/worktree.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,sDAAsD;AACtD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIrD;AA2CD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,WAAW,CAsBpE;AAED,MAAM,WAAW,YAAY;IAC3B,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,WAAW,EAChB,WAAW,EAAE,MAAM,GAClB,YAAY,CA4Cd;AAED,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAmBjG"}

package/dist/concurrency/worktree.js

@@ -0,0 +1,169 @@
+/**
+ * Git worktree wrappers (AC-9, AC-10, AC-17, NFR-5).
+ *
+ * `createWorktree` creates branch + worktree in one step, always based on
+ * main, so an in-flight session in the primary checkout is never moved
+ * off its branch (idea goal 2). Callers export AIDLC_WORKTREE=1 before
+ * firing on-instance-start actions so the shipped branch action no-ops
+ * (AC-10).
+ *
+ * Removal order (AC-17, design F6): worktree remove FIRST — the claim is
+ * released only after removal succeeds, so a dirty worktree keeps its
+ * instance locked.
+ */
+import { existsSync, realpathSync } from 'node:fs';
+import { basename, dirname, join, resolve, sep } from 'node:path';
+import { execFileSync } from 'node:child_process';
+/** Sanitize a path component to [a-z0-9-] (NFR-5). */
+export function sanitizeComponent(raw) {
+    const cleaned = raw.toLowerCase().replace(/[^a-z0-9-]+/g, '-').replace(/^-+|-+$/g, '');
+    if (cleaned === '')
+        throw new Error(`unusable path component: ${raw}`);
+    return cleaned;
+}
+function git(args, cwd) {
+    return execFileSync('git', args, {
+        cwd,
+        encoding: 'utf8',
+        stdio: ['ignore', 'pipe', 'pipe'],
+    }).trim();
+}
+/** Resolve symlinks on the deepest existing ancestor of `p` (design F8). */
+function realResolve(p) {
+    let probe = resolve(p);
+    const tail = [];
+    while (!existsSync(probe)) {
+        tail.unshift(basename(probe));
+        const parent = dirname(probe);
+        if (parent === probe)
+            break;
+        probe = parent;
+    }
+    try {
+        probe = realpathSync(probe);
+    }
+    catch {
+        // keep resolved path
+    }
+    return tail.length > 0 ? join(probe, ...tail) : probe;
+}
+/**
+ * Traversal guard (design F8): the worktree target must not live inside
+ * the project root or inside any `.git` directory.
+ */
+function assertSafeTarget(target, projectRoot) {
+    const realTarget = realResolve(target);
+    const realRoot = realResolve(projectRoot);
+    if (realTarget === realRoot || realTarget.startsWith(realRoot + sep)) {
+        throw new Error(`worktree target ${target} resolves inside the project root`);
+    }
+    if (realTarget.split(sep).includes('.git')) {
+        throw new Error(`worktree target ${target} resolves inside a .git directory`);
+    }
+}
+/**
+ * Create branch and worktree in one step, based on main (AC-9). Fails —
+ * never reuses — when the branch or target directory already exists (AC-24).
+ */
+export function createWorktree(opts) {
+    const stamp = opts.dateStamp ?? new Date().toISOString().slice(0, 10).replace(/-/g, '');
+    const name = sanitizeComponent(opts.name);
+    const repo = sanitizeComponent(basename(realResolve(opts.projectRoot)));
+    const branch = `${opts.prefix}/${stamp}-${name}`;
+    const target = resolve(opts.projectRoot, opts.worktreeDir, `${repo}-${name}`);
+    assertSafeTarget(target, opts.projectRoot);
+    if (existsSync(target)) {
+        throw new Error(`worktree target already exists: ${target}`);
+    }
+    try {
+        git(['show-ref', '--verify', '--quiet', `refs/heads/${branch}`], opts.projectRoot);
+        throw new Error(`branch already exists: ${branch}`);
+    }
+    catch (err) {
+        if (err.message.startsWith('branch already exists'))
+            throw err;
+        // show-ref failed → branch does not exist, proceed
+    }
+    git(['worktree', 'add', '-b', branch, target, 'main'], opts.projectRoot);
+    return { branch, path: target };
+}
+/**
+ * Remove a worktree and delete its branch iff merged into main (AC-17).
+ * A dirty worktree fails removal (no --force) and reports; the caller
+ * must NOT release the claim in that case (design F6).
+ */
+export function removeWorktree(ref, projectRoot) {
+    if (existsSync(ref.path)) {
+        try {
+            git(['worktree', 'remove', ref.path], projectRoot);
+        }
+        catch (err) {
+            return {
+                removedWorktree: false,
+                deletedBranch: false,
+                reason: `worktree not removed (dirty or locked): ${err.message.split('\n')[0]}`,
+            };
+        }
+    }
+    else {
+        // Directory already gone (manual removal) — let git drop the stale record.
+        try {
+            git(['worktree', 'prune'], projectRoot);
+        }
+        catch {
+            // non-fatal
+        }
+    }
+    let merged = false;
+    try {
+        git(['merge-base', '--is-ancestor', ref.branch, 'main'], projectRoot);
+        merged = true;
+    }
+    catch {
+        merged = false;
+    }
+    if (!merged) {
+        return {
+            removedWorktree: true,
+            deletedBranch: false,
+            reason: `branch ${ref.branch} is not merged into main — left in place`,
+        };
+    }
+    try {
+        git(['branch', '-d', ref.branch], projectRoot);
+        return { removedWorktree: true, deletedBranch: true };
+    }
+    catch (err) {
+        return {
+            removedWorktree: true,
+            deletedBranch: false,
+            reason: `branch not deleted: ${err.message.split('\n')[0]}`,
+        };
+    }
+}
+/** List worktrees known to git (for status cross-checks, AC-18). */
+export function listWorktrees(projectRoot) {
+    let out;
+    try {
+        out = git(['worktree', 'list', '--porcelain'], projectRoot);
+    }
+    catch {
+        return [];
+    }
+    const result = [];
+    let current = null;
+    for (const line of out.split('\n')) {
+        if (line.startsWith('worktree ')) {
+            if (current)
+                result.push(current);
+            current = { path: line.slice('worktree '.length), branch: null };
+        }
+        else if (line.startsWith('branch ') && current) {
+            current.branch = line.slice('branch refs/heads/'.length);
+        }
+    }
+    if (current)
+        result.push(current);
+    return result;
+}
+//# sourceMappingURL=worktree.js.map

package/dist/concurrency/worktree.js.map

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

package/dist/core/gate.d.ts

@@ -7,8 +7,9 @@
  *
  * Requirements: 9.1, 9.6
  */
-import type { PhaseState, WorkflowTemplate } from './types.js';
+import type { PhaseState, WorkflowTemplate, TemplatePhase } from './types.js';
 import type { TraceabilityResult } from '../traceability/types.js';
+import type { TasksResult } from '../tasks/types.js';
 /**
  * Gate check result for CI/CD integration.
  */
@@ -27,6 +28,13 @@ export interface GateCheckResult {
      * layer; evaluateGate itself never sets it (traceability-ids AC-15).
      */
     traceability?: TraceabilityResult;
+    /**
+     * Task breakdown result — present only when the tasks criterion evaluated
+     * (implementation phase, task-bearing or required-scope instance). Attached
+     * at the command layer; evaluateGate itself never sets it (task-breakdown
+     * AC-19).
+     */
+    tasks?: TasksResult;
 }
 /**
  * Evaluate whether a phase passes its gate check.
@@ -40,4 +48,14 @@ export interface GateCheckResult {
  * @returns A GateCheckResult indicating pass/fail with structured details.
  */
 export declare function evaluateGate(phaseName: string, phaseStates: Map<string, PhaseState>, template: WorkflowTemplate): GateCheckResult;
+/**
+ * Effective required artifacts for a phase, applying the tasks.md legacy
+ * filter (task-breakdown AC-27, design §5a): the design-phase `tasks.md`
+ * requirement binds only instances whose phase state carries a tasks.md
+ * artifact entry (seeded at `aidlc start` from the new templates).
+ * Pre-existing instances without the entry are legacy-allowed — mirroring
+ * the branch-gate "missing field = legacy-allowed" precedent. Deliberately
+ * narrow: only tasks.md, only the design phase.
+ */
+export declare function effectiveRequiredArtifacts(templatePhase: TemplatePhase, phaseState: PhaseState | undefined): TemplatePhase['required_artifacts'];
 //# sourceMappingURL=gate.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../../src/core/gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAiB,MAAM,YAAY,CAAC;AAC9E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAMnE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,IAAI,EAAE,OAAO,CAAC;IACd,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,8DAA8D;IAC9D,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B;;;;OAIG;IACH,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EACpC,QAAQ,EAAE,gBAAgB,GACzB,eAAe,CAiCjB"}
+{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../../src/core/gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC9E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMrD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,IAAI,EAAE,OAAO,CAAC;IACd,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,8DAA8D;IAC9D,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B;;;;OAIG;IACH,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EACpC,QAAQ,EAAE,gBAAgB,GACzB,eAAe,CAiCjB;AAMD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,aAAa,EAC5B,UAAU,EAAE,UAAU,GAAG,SAAS,GACjC,aAAa,CAAC,oBAAoB,CAAC,CAKrC"}

package/dist/core/gate.js

@@ -54,6 +54,23 @@ export function evaluateGate(phaseName, phaseStates, template) {
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
+/**
+ * Effective required artifacts for a phase, applying the tasks.md legacy
+ * filter (task-breakdown AC-27, design §5a): the design-phase `tasks.md`
+ * requirement binds only instances whose phase state carries a tasks.md
+ * artifact entry (seeded at `aidlc start` from the new templates).
+ * Pre-existing instances without the entry are legacy-allowed — mirroring
+ * the branch-gate "missing field = legacy-allowed" precedent. Deliberately
+ * narrow: only tasks.md, only the design phase.
+ */
+export function effectiveRequiredArtifacts(templatePhase, phaseState) {
+    const required = templatePhase.required_artifacts ?? [];
+    if (templatePhase.name !== 'design' || !phaseState)
+        return required;
+    if (phaseState.artifacts.some((a) => a.name === 'tasks.md'))
+        return required;
+    return required.filter((decl) => decl.name !== 'tasks.md');
+}
 /**
  * Determine which required artifacts from the template are not yet 'complete'
  * in the phase state.
@@ -70,7 +87,7 @@ function getMissingArtifacts(phaseName, state, template) {
         .filter((a) => a.status === 'complete')
         .map((a) => a.name));
     // Find required artifacts that are not complete
-    return templatePhase.required_artifacts
+    return effectiveRequiredArtifacts(templatePhase, state)
         .filter((decl) => !completedArtifacts.has(decl.name))
         .map((decl) => decl.name);
 }

package/dist/core/gate.js.map

@@ -1 +1 @@
-{"version":3,"file":"gate.js","sourceRoot":"","sources":["../../src/core/gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA6BH,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAC1B,SAAiB,EACjB,WAAoC,EACpC,QAA0B;IAE1B,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAEzC,2BAA2B;IAC3B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,IAAI,EAAE,KAAK;YACX,KAAK,EAAE,SAAS;YAChB,gBAAgB,EAAE,EAAE;YACpB,mBAAmB,EAAE,CAAC,mCAAmC,CAAC;SAC3D,CAAC;IACJ,CAAC;IAED,kCAAkC;IAClC,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAChC,OAAO;YACL,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,SAAS;YAChB,gBAAgB,EAAE,EAAE;YACpB,mBAAmB,EAAE,EAAE;SACxB,CAAC;IACJ,CAAC;IAED,yEAAyE;IACzE,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IACzE,MAAM,mBAAmB,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAE1D,OAAO;QACL,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,SAAS;QAChB,gBAAgB;QAChB,mBAAmB;KACpB,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;GAGG;AACH,SAAS,mBAAmB,CAC1B,SAAiB,EACjB,KAAiB,EACjB,QAA0B;IAE1B,qCAAqC;IACrC,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CACxC,CAAC,CAAgB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAC3C,CAAC;IAEF,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,6EAA6E;QAC7E,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,mEAAmE;IACnE,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAChC,KAAK,CAAC,SAAS;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC;SACtC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CACtB,CAAC;IAEF,gDAAgD;IAChD,OAAO,aAAa,CAAC,kBAAkB;SACpC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SACpD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB,CAAC,KAAiB;IAC/C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,QAAQ,KAAK,CAAC,MAAM,EAAE,CAAC;QACrB,KAAK,SAAS;YACZ,QAAQ,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;YAC9D,MAAM;QACR,KAAK,aAAa;YAChB,QAAQ,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;YAClE,MAAM;QACR,KAAK,SAAS;YACZ,QAAQ,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;YACrD,MAAM;QACR;YACE,QAAQ,CAAC,IAAI,CAAC,oBAAoB,KAAK,CAAC,MAAM,wBAAwB,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"gate.js","sourceRoot":"","sources":["../../src/core/gate.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/core/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,QAAQ,EAER,aAAa,EACb,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAOpB;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EACpC,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,GAC7B,MAAM,CA2BR;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EACpC,QAAQ,EAAE,gBAAgB,EAC1B,GAAG,EAAE,IAAI,EACT,aAAa,EAAE,MAAM,GACpB,OAAO,CAeT;AAOD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EACpC,QAAQ,EAAE,gBAAgB,GACzB,QAAQ,CA+CV;AA8ED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EACpC,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,aAAa,EACvB,QAAQ,CAAC,EAAE,OAAO,GACjB,gBAAgB,CAiClB"}
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/core/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,QAAQ,EAER,aAAa,EACb,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAQpB;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EACpC,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,GAC7B,MAAM,CA4BR;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EACpC,QAAQ,EAAE,gBAAgB,EAC1B,GAAG,EAAE,IAAI,EACT,aAAa,EAAE,MAAM,GACpB,OAAO,CAeT;AAOD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EACpC,QAAQ,EAAE,gBAAgB,GACzB,QAAQ,CA+CV;AA8ED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EACpC,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,aAAa,EACvB,QAAQ,CAAC,EAAE,OAAO,GACjB,gBAAgB,CAiClB"}