@aperant/framework 0.6.2

package/dist/cli/constitution/match.mjs

@@ -0,0 +1,163 @@
+/**
+ * @internal
+ * constitution/match.mjs — principle-vs-spec matcher (C14 subtask 2).
+ *
+ * matchPrinciple(principle, specMarkdown) -> Match
+ *
+ * Match = {
+ *   status:    'covered' | 'na' | 'missing',
+ *   evidence: {
+ *     matched_keywords: string[],
+ *     lines:            number[],
+ *     na_reason?:       string,
+ *   }
+ * }
+ *
+ * Algorithm (order matters):
+ *
+ *   1. If spec.md contains a `## Constitution Coverage` section and
+ *      that section has a line of the exact form
+ *      `- [{principle.id}] N/A: <reason>`  → status = 'na' (na_reason set).
+ *      A `covered:` opt-in in the same section is informational only — the
+ *      keyword heuristic still runs so we don't trust unverified author claims.
+ *
+ *   2. Count distinct keyword hits (case-insensitive, word-boundary) over the
+ *      full spec. A principle is `covered` when
+ *        hits >= max(2, ceil(principle.keywords.length * 0.3)).
+ *
+ *   3. Single-keyword principles fall back to an exact title-phrase match
+ *      (case-insensitive substring) — keyword overlap would otherwise gate
+ *      on a single hit which is too noisy.
+ *
+ *   4. Otherwise → `missing`.
+ */
+/**
+ * Escape a string for safe use inside a RegExp literal.
+ */
+function escapeRegExp(str) {
+    return String(str).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Locate the `## Constitution Coverage` section boundary and return the
+ * 1-indexed [start, end) line range that contains its body (not the heading).
+ * Returns null when no such section exists.
+ */
+function findCoverageSection(specLines) {
+    const headingRe = /^#{1,6}\s+constitution\s+coverage\s*$/i;
+    for (let i = 0; i < specLines.length; i++) {
+        if (headingRe.test(specLines[i].trim())) {
+            // Find the next heading of the same or shallower depth, or EOF.
+            const headingLevel = (specLines[i].match(/^#+/) ?? [''])[0].length;
+            let end = specLines.length;
+            for (let j = i + 1; j < specLines.length; j++) {
+                const m = specLines[j].match(/^(#+)\s+/);
+                if (m && m[1].length <= headingLevel) {
+                    end = j;
+                    break;
+                }
+            }
+            return { start: i + 1, end };
+        }
+    }
+    return null;
+}
+/**
+ * Look for an N/A opt-out bullet `- [{id}] N/A: <reason>` inside the
+ * Constitution Coverage section. Returns the trimmed reason (possibly '')
+ * when found, or null when absent.
+ */
+function findNaOptOut(specLines, principleId) {
+    const section = findCoverageSection(specLines);
+    if (!section)
+        return null;
+    const idEscaped = escapeRegExp(principleId);
+    const re = new RegExp(`^\\s*-\\s*\\[${idEscaped}\\]\\s*N\\/A\\s*:\\s*(.*)$`, 'i');
+    for (let i = section.start; i < section.end; i++) {
+        const m = re.exec(specLines[i]);
+        if (m)
+            return m[1].trim();
+    }
+    return null;
+}
+/**
+ * Match a single principle against a spec.md markdown string.
+ *
+ * @param {{
+ *   id: string,
+ *   title: string,
+ *   text?: string,
+ *   keywords: string[],
+ *   severity?: string,
+ * }} principle
+ * @param {string} specMarkdown
+ * @returns {{
+ *   status: 'covered' | 'na' | 'missing',
+ *   evidence: { matched_keywords: string[], lines: number[], na_reason?: string }
+ * }}
+ */
+export function matchPrinciple(principle, specMarkdown) {
+    const specText = typeof specMarkdown === 'string' ? specMarkdown : '';
+    const specLines = specText.split(/\r?\n/);
+    // Rule 1 — explicit N/A opt-out under ## Constitution Coverage.
+    const naReason = findNaOptOut(specLines, principle.id);
+    if (naReason !== null) {
+        return {
+            status: 'na',
+            evidence: {
+                matched_keywords: [],
+                lines: [],
+                na_reason: naReason,
+            },
+        };
+    }
+    const keywords = Array.isArray(principle.keywords) ? principle.keywords : [];
+    const matchedSet = new Set();
+    const matchedLines = new Set();
+    // Rule 2 / 3 — keyword-overlap scan. Case-insensitive, word-boundary.
+    for (const kw of keywords) {
+        if (!kw || typeof kw !== 'string')
+            continue;
+        const re = new RegExp(`\\b${escapeRegExp(kw)}\\b`, 'i');
+        for (let i = 0; i < specLines.length; i++) {
+            if (re.test(specLines[i])) {
+                matchedSet.add(kw.toLowerCase());
+                matchedLines.add(i + 1);
+                break; // one hit per keyword is enough; move on
+            }
+        }
+    }
+    const distinctHits = matchedSet.size;
+    const threshold = Math.max(2, Math.ceil(keywords.length * 0.3));
+    if (keywords.length >= 2 && distinctHits >= threshold) {
+        return {
+            status: 'covered',
+            evidence: {
+                matched_keywords: [...matchedSet],
+                lines: [...matchedLines].sort((a, b) => a - b),
+            },
+        };
+    }
+    // Rule 3 — single-keyword fallback: try an exact title-phrase substring.
+    if (keywords.length <= 1 && typeof principle.title === 'string' && principle.title.length > 0) {
+        const needle = principle.title.trim().toLowerCase();
+        for (let i = 0; i < specLines.length; i++) {
+            if (specLines[i].toLowerCase().includes(needle)) {
+                return {
+                    status: 'covered',
+                    evidence: {
+                        matched_keywords: keywords.map((k) => k.toLowerCase()),
+                        lines: [i + 1],
+                    },
+                };
+            }
+        }
+    }
+    return {
+        status: 'missing',
+        evidence: {
+            matched_keywords: [...matchedSet],
+            lines: [...matchedLines].sort((a, b) => a - b),
+        },
+    };
+}
+//# sourceMappingURL=match.mjs.map

package/dist/cli/constitution/match.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.mjs","sourceRoot":"","sources":["../../../src/cli/constitution/match.mjs"],"names":[],"mappings":"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"}

package/dist/cli/constitution/parse.d.mts

@@ -0,0 +1,40 @@
+/**
+ * Extract principles from an AGENTS.md markdown string.
+ *
+ * @param {string} markdown
+ * @returns {Array<{
+ *   id: string,
+ *   title: string,
+ *   text: string,
+ *   source: { section: string, line: number },
+ *   keywords: string[],
+ *   severity: 'must'|'should'|'never'|'principle'|'obligation'
+ * }>}
+ */
+export function parseAgentsMd(markdown: string): Array<{
+    id: string;
+    title: string;
+    text: string;
+    source: {
+        section: string;
+        line: number;
+    };
+    keywords: string[];
+    severity: "must" | "should" | "never" | "principle" | "obligation";
+}>;
+/**
+ * Derive keywords from a text chunk:
+ *   lowercase → strip non-[a-z0-9] → drop stopwords → keep len >= 4 → dedup.
+ */
+export function deriveKeywords(text: any): string[];
+/**
+ * Normalize a title for dedup: lowercase + collapse whitespace + strip
+ * punctuation.
+ */
+export function normalizeTitle(title: any): string;
+/**
+ * Lowercase + replace non-alphanumerics with hyphens + trim.
+ * Used for building stable slug ids.
+ */
+export function slugify(text: any): string;
+//# sourceMappingURL=parse.d.mts.map

package/dist/cli/constitution/parse.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.mts","sourceRoot":"","sources":["../../../src/cli/constitution/parse.mjs"],"names":[],"mappings":"AA+JA;;;;;;;;;;;;GAYG;AACH,wCAVW,MAAM,GACJ,KAAK,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAC,QAAQ,GAAC,OAAO,GAAC,WAAW,GAAC,YAAY,CAAA;CAC3D,CAAC,CA4LJ;AAxRD;;;GAGG;AACH,oDAeC;AAED;;;GAGG;AACH,mDAMC;AA3CD;;;GAGG;AACH,2CAMC"}

package/dist/cli/constitution/parse.mjs

@@ -0,0 +1,351 @@
+/**
+ * @internal
+ * constitution/parse.mjs — AGENTS.md principle extractor (C14 subtask 1).
+ *
+ * Pure function: parseAgentsMd(markdown) -> Principle[]
+ *
+ * A Principle is:
+ *   {
+ *     id:       string,      // stable slug
+ *     title:    string,      // human-readable first line / heading
+ *     text:     string,      // the matched chunk (keyword seed)
+ *     source:   { section: string, line: number },
+ *     keywords: string[],    // derived, deduped, stopword-stripped
+ *     severity: 'must' | 'should' | 'never' | 'principle' | 'obligation'
+ *   }
+ *
+ * Extraction rules (applied in order, dedup by normalized title):
+ *   1. Numbered lists under a heading matching /principles?|constraints?|rules?/i
+ *      → severity 'principle', id `p{n}-{slug(title)}`.
+ *   2. Bullets (any depth) containing a standalone MUST/SHOULD/NEVER token
+ *      (word-boundary, case-sensitive) → severity from the token,
+ *      id `{severity}-{slug(first-5-words)}`.
+ *   3. Rows of the "Deployment Modes" + "Obligations" table →
+ *      one principle per row + an umbrella principle
+ *      `deployment-modes-all-modes` whose keywords include every mode name.
+ *
+ * Returns `[]` (not throws) on empty string or markdown with no matches.
+ */
+const STOPWORDS = new Set([
+    'the',
+    'a',
+    'an',
+    'and',
+    'or',
+    'of',
+    'for',
+    'to',
+    'in',
+    'on',
+    'must',
+    'should',
+    'never',
+    'with',
+    'without',
+    'is',
+    'are',
+    'this',
+    'that',
+    'these',
+    'those',
+    'be',
+    'been',
+    'being',
+    'have',
+    'has',
+    'had',
+    'not',
+    'but',
+    'from',
+    'into',
+    'over',
+    'under',
+    'its',
+]);
+/**
+ * Lowercase + replace non-alphanumerics with hyphens + trim.
+ * Used for building stable slug ids.
+ */
+function slugify(text) {
+    return String(text)
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 60);
+}
+/**
+ * Derive keywords from a text chunk:
+ *   lowercase → strip non-[a-z0-9] → drop stopwords → keep len >= 4 → dedup.
+ */
+function deriveKeywords(text) {
+    const seen = new Set();
+    const out = [];
+    const tokens = String(text)
+        .toLowerCase()
+        .split(/[^a-z0-9]+/g)
+        .filter(Boolean);
+    for (const tok of tokens) {
+        if (tok.length < 4)
+            continue;
+        if (STOPWORDS.has(tok))
+            continue;
+        if (seen.has(tok))
+            continue;
+        seen.add(tok);
+        out.push(tok);
+    }
+    return out;
+}
+/**
+ * Normalize a title for dedup: lowercase + collapse whitespace + strip
+ * punctuation.
+ */
+function normalizeTitle(title) {
+    return String(title)
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]+/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+/**
+ * Detect a `## Heading` or `### Heading` line. Returns {level, title} or null.
+ */
+function parseHeading(line) {
+    const m = /^(#{1,6})\s+(.+?)\s*$/.exec(line);
+    if (!m)
+        return null;
+    return { level: m[1].length, title: m[2] };
+}
+/**
+ * Strip markdown bullet/numbering prefix and any bold wrappers so the caller
+ * sees the raw text content of a bullet line.
+ */
+function stripBulletPrefix(line) {
+    return line
+        .replace(/^\s*(?:[-*+]|\d+\.)\s+/, '')
+        .replace(/^\*\*(.+?)\*\*/, '$1')
+        .trim();
+}
+/**
+ * Return true when the line starts a bullet (any depth) or a numbered item.
+ */
+function isBullet(line) {
+    return /^\s*(?:[-*+]|\d+\.)\s+/.test(line);
+}
+/**
+ * Return true when the line looks like a Principles/Constraints/Rules heading.
+ */
+function isPrinciplesHeading(title) {
+    return /principles?|constraints?|rules?/i.test(title);
+}
+/**
+ * Return true when the line looks like the Deployment-Modes obligation heading.
+ */
+function isDeploymentModesHeading(title) {
+    return /deployment\s*modes/i.test(title) && /obligation/i.test(title);
+}
+/**
+ * Pull the first N words out of a text chunk (used for slug seeds).
+ */
+function firstWords(text, n) {
+    return String(text).split(/\s+/).slice(0, n).join(' ');
+}
+/**
+ * Extract principles from an AGENTS.md markdown string.
+ *
+ * @param {string} markdown
+ * @returns {Array<{
+ *   id: string,
+ *   title: string,
+ *   text: string,
+ *   source: { section: string, line: number },
+ *   keywords: string[],
+ *   severity: 'must'|'should'|'never'|'principle'|'obligation'
+ * }>}
+ */
+export function parseAgentsMd(markdown) {
+    if (typeof markdown !== 'string' || markdown.length === 0)
+        return [];
+    const lines = markdown.split(/\r?\n/);
+    const principles = [];
+    const seenTitles = new Set();
+    function push(p) {
+        const key = normalizeTitle(p.title);
+        if (!key)
+            return;
+        if (seenTitles.has(key))
+            return;
+        seenTitles.add(key);
+        principles.push(p);
+    }
+    // Track state across lines.
+    let section = '(root)';
+    let inPrinciples = false;
+    let principlesCounter = 0;
+    let tableHeadingSection = null;
+    let tableHeaderLine = null;
+    let tableHeaderCols = null;
+    let tableRowsSeen = 0;
+    const deploymentModeNames = [];
+    for (let i = 0; i < lines.length; i++) {
+        const rawLine = lines[i];
+        const line = rawLine;
+        const heading = parseHeading(line);
+        if (heading) {
+            // If we were mid-way through a deployment-modes table and a new
+            // heading appears, finalize the umbrella principle for the rows
+            // we already collected before we lose the state.
+            if (tableHeadingSection && tableRowsSeen > 0) {
+                const umbrellaText = `Deployment modes: ${deploymentModeNames.join(', ')}`;
+                push({
+                    id: 'deployment-modes-all-modes',
+                    title: 'Deployment modes — all modes covered',
+                    text: umbrellaText,
+                    source: { section: tableHeadingSection, line: tableHeaderLine ?? i + 1 },
+                    keywords: [
+                        'deployment',
+                        'modes',
+                        ...deploymentModeNames.map((m) => slugify(m).replace(/-/g, '')),
+                        ...deriveKeywords(umbrellaText),
+                    ].filter(Boolean),
+                    severity: 'obligation',
+                });
+            }
+            section = heading.title;
+            inPrinciples = isPrinciplesHeading(heading.title);
+            if (inPrinciples)
+                principlesCounter = 0;
+            // Deployment-modes detection — next non-blank bullet block below
+            // triggers table parsing.
+            if (isDeploymentModesHeading(heading.title)) {
+                tableHeadingSection = heading.title;
+                tableHeaderLine = null;
+                tableHeaderCols = null;
+                tableRowsSeen = 0;
+            }
+            else {
+                // A non-deployment heading clears any partially-collected table
+                // state (we only read the table directly below its heading).
+                if (tableHeadingSection && i > 0) {
+                    tableHeadingSection = null;
+                    tableHeaderCols = null;
+                    tableRowsSeen = 0;
+                }
+            }
+            continue;
+        }
+        // Rule 3 — Deployment Modes table rows.
+        if (tableHeadingSection) {
+            // Table detection: a line starting with `|` is a table row; header
+            // is followed by a `|---|---|` separator.
+            if (/^\s*\|/.test(line)) {
+                const cols = line
+                    .trim()
+                    .replace(/^\|/, '')
+                    .replace(/\|\s*$/, '')
+                    .split('|')
+                    .map((c) => c.trim());
+                if (!tableHeaderCols) {
+                    tableHeaderCols = cols;
+                    tableHeaderLine = i + 1;
+                    continue;
+                }
+                // Separator row — skip.
+                if (cols.every((c) => /^:?-+:?$/.test(c)))
+                    continue;
+                // Data row → first column is the mode name.
+                const modeName = cols[0].replace(/\*\*/g, '').trim();
+                if (!modeName)
+                    continue;
+                const rowText = cols.join(' ');
+                tableRowsSeen++;
+                deploymentModeNames.push(modeName);
+                push({
+                    id: `deployment-mode-${slugify(modeName)}`,
+                    title: `Deployment mode: ${modeName}`,
+                    text: rowText,
+                    source: { section: tableHeadingSection, line: i + 1 },
+                    keywords: deriveKeywords(`${modeName} ${rowText}`),
+                    severity: 'obligation',
+                });
+                continue;
+            }
+            // A non-table, non-blank line after we started collecting rows
+            // means the table has ended. Finalize the umbrella principle.
+            if (tableRowsSeen > 0 && line.trim().length > 0) {
+                const umbrellaText = `Deployment modes: ${deploymentModeNames.join(', ')}`;
+                push({
+                    id: 'deployment-modes-all-modes',
+                    title: 'Deployment modes — all modes covered',
+                    text: umbrellaText,
+                    source: { section: tableHeadingSection, line: tableHeaderLine ?? i + 1 },
+                    keywords: [
+                        'deployment',
+                        'modes',
+                        ...deploymentModeNames.map((m) => slugify(m).replace(/-/g, '')),
+                        ...deriveKeywords(umbrellaText),
+                    ].filter(Boolean),
+                    severity: 'obligation',
+                });
+                tableHeadingSection = null;
+                tableHeaderCols = null;
+                tableRowsSeen = 0;
+            }
+        }
+        // Rule 1 — numbered list under a Principles/Constraints/Rules heading.
+        if (inPrinciples && /^\s*\d+\.\s+/.test(line)) {
+            principlesCounter++;
+            const body = stripBulletPrefix(line);
+            const titleSeed = firstWords(body.replace(/[.:]/g, ' '), 5);
+            push({
+                id: `p${principlesCounter}-${slugify(titleSeed)}`,
+                title: body,
+                text: body,
+                source: { section, line: i + 1 },
+                keywords: deriveKeywords(body),
+                severity: 'principle',
+            });
+            continue;
+        }
+        // Rule 2 — bullets with a standalone MUST/SHOULD/NEVER token.
+        if (isBullet(line)) {
+            const body = stripBulletPrefix(line);
+            // MUST NOT should still count as 'must' (rule hits MUST first).
+            const tokenMatch = /\b(MUST|SHOULD|NEVER)\b/.exec(body);
+            if (tokenMatch) {
+                const severity = tokenMatch[1].toLowerCase();
+                const titleSeed = firstWords(body.replace(/[.:]/g, ' '), 5);
+                push({
+                    id: `${severity}-${slugify(titleSeed)}`,
+                    title: body,
+                    text: body,
+                    source: { section, line: i + 1 },
+                    keywords: deriveKeywords(body),
+                    severity,
+                });
+            }
+        }
+    }
+    // If the file ends while a deployment-modes table was still open, emit
+    // the umbrella principle now.
+    if (tableHeadingSection && tableRowsSeen > 0) {
+        const umbrellaText = `Deployment modes: ${deploymentModeNames.join(', ')}`;
+        push({
+            id: 'deployment-modes-all-modes',
+            title: 'Deployment modes — all modes covered',
+            text: umbrellaText,
+            source: { section: tableHeadingSection, line: tableHeaderLine ?? lines.length },
+            keywords: [
+                'deployment',
+                'modes',
+                ...deploymentModeNames.map((m) => slugify(m).replace(/-/g, '')),
+                ...deriveKeywords(umbrellaText),
+            ].filter(Boolean),
+            severity: 'obligation',
+        });
+    }
+    return principles;
+}
+// Re-export helpers so match.mjs / tests can reuse the same stopword policy.
+export { deriveKeywords, normalizeTitle, slugify };
+//# sourceMappingURL=parse.mjs.map

package/dist/cli/constitution/parse.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.mjs","sourceRoot":"","sources":["../../../src/cli/constitution/parse.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;IACzB,KAAK;IACL,GAAG;IACH,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,MAAM;IACN,QAAQ;IACR,OAAO;IACP,MAAM;IACN,SAAS;IACT,IAAI;IACJ,KAAK;IACL,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,IAAI;IACJ,MAAM;IACN,OAAO;IACP,MAAM;IACN,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,KAAK;CACL,CAAC,CAAA;AAEF;;;GAGG;AACH,SAAS,OAAO,CAAC,IAAI;IACpB,OAAO,MAAM,CAAC,IAAI,CAAC;SACjB,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;AACf,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,IAAI;IAC3B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAE,CAAA;IACtB,MAAM,GAAG,GAAG,EAAE,CAAA;IACd,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC;SACzB,WAAW,EAAE;SACb,KAAK,CAAC,aAAa,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC,CAAA;IACjB,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QAC1B,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;YAAE,SAAQ;QAC5B,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAQ;QAChC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAQ;QAC3B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACb,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACd,CAAC;IACD,OAAO,GAAG,CAAA;AACX,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,KAAK;IAC5B,OAAO,MAAM,CAAC,KAAK,CAAC;SAClB,WAAW,EAAE;SACb,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC;SAC7B,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAA;AACT,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,IAAI;IACzB,MAAM,CAAC,GAAG,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC5C,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IACnB,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AAC3C,CAAC;AAED;;;GAGG;AACH,SAAS,iBAAiB,CAAC,IAAI;IAC9B,OAAO,IAAI;SACT,OAAO,CAAC,wBAAwB,EAAE,EAAE,CAAC;SACrC,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAAC;SAC/B,IAAI,EAAE,CAAA;AACT,CAAC;AAED;;GAEG;AACH,SAAS,QAAQ,CAAC,IAAI;IACrB,OAAO,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC3C,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,KAAK;IACjC,OAAO,kCAAkC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AACtD,CAAC;AAED;;GAEG;AACH,SAAS,wBAAwB,CAAC,KAAK;IACtC,OAAO,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AACtE,CAAC;AAED;;GAEG;AACH,SAAS,UAAU,CAAC,IAAI,EAAE,CAAC;IAC1B,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACvD,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa,CAAC,QAAQ;IACrC,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IACpE,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAErC,MAAM,UAAU,GAAG,EAAE,CAAA;IACrB,MAAM,UAAU,GAAG,IAAI,GAAG,EAAE,CAAA;IAE5B,SAAS,IAAI,CAAC,CAAC;QACd,MAAM,GAAG,GAAG,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;QACnC,IAAI,CAAC,GAAG;YAAE,OAAM;QAChB,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAM;QAC/B,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACnB,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACnB,CAAC;IAED,4BAA4B;IAC5B,IAAI,OAAO,GAAG,QAAQ,CAAA;IACtB,IAAI,YAAY,GAAG,KAAK,CAAA;IACxB,IAAI,iBAAiB,GAAG,CAAC,CAAA;IACzB,IAAI,mBAAmB,GAAG,IAAI,CAAA;IAC9B,IAAI,eAAe,GAAG,IAAI,CAAA;IAC1B,IAAI,eAAe,GAAG,IAAI,CAAA;IAC1B,IAAI,aAAa,GAAG,CAAC,CAAA;IACrB,MAAM,mBAAmB,GAAG,EAAE,CAAA;IAE9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;QACxB,MAAM,IAAI,GAAG,OAAO,CAAA;QAEpB,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;QAClC,IAAI,OAAO,EAAE,CAAC;YACb,gEAAgE;YAChE,gEAAgE;YAChE,iDAAiD;YACjD,IAAI,mBAAmB,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;gBAC9C,MAAM,YAAY,GAAG,qBAAqB,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAA;gBAC1E,IAAI,CAAC;oBACJ,EAAE,EAAE,4BAA4B;oBAChC,KAAK,EAAE,sCAAsC;oBAC7C,IAAI,EAAE,YAAY;oBAClB,MAAM,EAAE,EAAE,OAAO,EAAE,mBAAmB,EAAE,IAAI,EAAE,eAAe,IAAI,CAAC,GAAG,CAAC,EAAE;oBACxE,QAAQ,EAAE;wBACT,YAAY;wBACZ,OAAO;wBACP,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;wBAC/D,GAAG,cAAc,CAAC,YAAY,CAAC;qBAC/B,CAAC,MAAM,CAAC,OAAO,CAAC;oBACjB,QAAQ,EAAE,YAAY;iBACtB,CAAC,CAAA;YACH,CAAC;YAED,OAAO,GAAG,OAAO,CAAC,KAAK,CAAA;YACvB,YAAY,GAAG,mBAAmB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;YACjD,IAAI,YAAY;gBAAE,iBAAiB,GAAG,CAAC,CAAA;YACvC,iEAAiE;YACjE,0BAA0B;YAC1B,IAAI,wBAAwB,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7C,mBAAmB,GAAG,OAAO,CAAC,KAAK,CAAA;gBACnC,eAAe,GAAG,IAAI,CAAA;gBACtB,eAAe,GAAG,IAAI,CAAA;gBACtB,aAAa,GAAG,CAAC,CAAA;YAClB,CAAC;iBAAM,CAAC;gBACP,gEAAgE;gBAChE,6DAA6D;gBAC7D,IAAI,mBAAmB,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBAClC,mBAAmB,GAAG,IAAI,CAAA;oBAC1B,eAAe,GAAG,IAAI,CAAA;oBACtB,aAAa,GAAG,CAAC,CAAA;gBAClB,CAAC;YACF,CAAC;YACD,SAAQ;QACT,CAAC;QAED,wCAAwC;QACxC,IAAI,mBAAmB,EAAE,CAAC;YACzB,mEAAmE;YACnE,0CAA0C;YAC1C,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,MAAM,IAAI,GAAG,IAAI;qBACf,IAAI,EAAE;qBACN,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;qBAClB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;qBACrB,KAAK,CAAC,GAAG,CAAC;qBACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;gBACtB,IAAI,CAAC,eAAe,EAAE,CAAC;oBACtB,eAAe,GAAG,IAAI,CAAA;oBACtB,eAAe,GAAG,CAAC,GAAG,CAAC,CAAA;oBACvB,SAAQ;gBACT,CAAC;gBACD,wBAAwB;gBACxB,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;oBAAE,SAAQ;gBACnD,4CAA4C;gBAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;gBACpD,IAAI,CAAC,QAAQ;oBAAE,SAAQ;gBACvB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;gBAC9B,aAAa,EAAE,CAAA;gBACf,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;gBAClC,IAAI,CAAC;oBACJ,EAAE,EAAE,mBAAmB,OAAO,CAAC,QAAQ,CAAC,EAAE;oBAC1C,KAAK,EAAE,oBAAoB,QAAQ,EAAE;oBACrC,IAAI,EAAE,OAAO;oBACb,MAAM,EAAE,EAAE,OAAO,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE;oBACrD,QAAQ,EAAE,cAAc,CAAC,GAAG,QAAQ,IAAI,OAAO,EAAE,CAAC;oBAClD,QAAQ,EAAE,YAAY;iBACtB,CAAC,CAAA;gBACF,SAAQ;YACT,CAAC;YACD,+DAA+D;YAC/D,8DAA8D;YAC9D,IAAI,aAAa,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjD,MAAM,YAAY,GAAG,qBAAqB,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAA;gBAC1E,IAAI,CAAC;oBACJ,EAAE,EAAE,4BAA4B;oBAChC,KAAK,EAAE,sCAAsC;oBAC7C,IAAI,EAAE,YAAY;oBAClB,MAAM,EAAE,EAAE,OAAO,EAAE,mBAAmB,EAAE,IAAI,EAAE,eAAe,IAAI,CAAC,GAAG,CAAC,EAAE;oBACxE,QAAQ,EAAE;wBACT,YAAY;wBACZ,OAAO;wBACP,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;wBAC/D,GAAG,cAAc,CAAC,YAAY,CAAC;qBAC/B,CAAC,MAAM,CAAC,OAAO,CAAC;oBACjB,QAAQ,EAAE,YAAY;iBACtB,CAAC,CAAA;gBACF,mBAAmB,GAAG,IAAI,CAAA;gBAC1B,eAAe,GAAG,IAAI,CAAA;gBACtB,aAAa,GAAG,CAAC,CAAA;YAClB,CAAC;QACF,CAAC;QAED,uEAAuE;QACvE,IAAI,YAAY,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/C,iBAAiB,EAAE,CAAA;YACnB,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAA;YACpC,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;YAC3D,IAAI,CAAC;gBACJ,EAAE,EAAE,IAAI,iBAAiB,IAAI,OAAO,CAAC,SAAS,CAAC,EAAE;gBACjD,KAAK,EAAE,IAAI;gBACX,IAAI,EAAE,IAAI;gBACV,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE;gBAChC,QAAQ,EAAE,cAAc,CAAC,IAAI,CAAC;gBAC9B,QAAQ,EAAE,WAAW;aACrB,CAAC,CAAA;YACF,SAAQ;QACT,CAAC;QAED,8DAA8D;QAC9D,IAAI,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAA;YACpC,gEAAgE;YAChE,MAAM,UAAU,GAAG,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACvD,IAAI,UAAU,EAAE,CAAC;gBAChB,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;gBAC5C,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;gBAC3D,IAAI,CAAC;oBACJ,EAAE,EAAE,GAAG,QAAQ,IAAI,OAAO,CAAC,SAAS,CAAC,EAAE;oBACvC,KAAK,EAAE,IAAI;oBACX,IAAI,EAAE,IAAI;oBACV,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE;oBAChC,QAAQ,EAAE,cAAc,CAAC,IAAI,CAAC;oBAC9B,QAAQ;iBACR,CAAC,CAAA;YACH,CAAC;QACF,CAAC;IACF,CAAC;IAED,uEAAuE;IACvE,8BAA8B;IAC9B,IAAI,mBAAmB,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,YAAY,GAAG,qBAAqB,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAA;QAC1E,IAAI,CAAC;YACJ,EAAE,EAAE,4BAA4B;YAChC,KAAK,EAAE,sCAAsC;YAC7C,IAAI,EAAE,YAAY;YAClB,MAAM,EAAE,EAAE,OAAO,EAAE,mBAAmB,EAAE,IAAI,EAAE,eAAe,IAAI,KAAK,CAAC,MAAM,EAAE;YAC/E,QAAQ,EAAE;gBACT,YAAY;gBACZ,OAAO;gBACP,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC/D,GAAG,cAAc,CAAC,YAAY,CAAC;aAC/B,CAAC,MAAM,CAAC,OAAO,CAAC;YACjB,QAAQ,EAAE,YAAY;SACtB,CAAC,CAAA;IACH,CAAC;IAED,OAAO,UAAU,CAAA;AAClB,CAAC;AAED,6EAA6E;AAC7E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,OAAO,EAAE,CAAA"}

package/dist/cli/coordination/agent-identity.d.mts

@@ -0,0 +1,22 @@
+/**
+ * Resolve the shared coordination root — always the main repo's root, even
+ * when called from a worktree. Mirrors commands/event.mjs.
+ */
+export function resolveSharedRoot(projectDir: any): any;
+/**
+ * Return the current agent's identity. Cached per project root so repeated
+ * callers within a single process see a stable incarnation.
+ *
+ * `APT_AGENT_ID` overrides the default `<hostname>-<pid>` assembly — used by
+ * tests to force a deterministic id.
+ */
+export function getAgentIdentity(projectDir: any): any;
+/**
+ * Test-only helper: reset the process-local identity cache so a fresh
+ * getAgentIdentity() call picks up a new incarnation. Not part of the public
+ * surface.
+ *
+ * @internal
+ */
+export function __resetAgentIdentityCacheForTests(): void;
+//# sourceMappingURL=agent-identity.d.mts.map

package/dist/cli/coordination/agent-identity.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-identity.d.mts","sourceRoot":"","sources":["../../../src/cli/coordination/agent-identity.mjs"],"names":[],"mappings":"AA2BA;;;GAGG;AACH,wDAGC;AAsCD;;;;;;GAMG;AACH,uDAWC;AAED;;;;;;GAMG;AACH,0DAEC"}