@plazmodium/odin 0.3.2-beta

package/dist/domain/development-evals.js

@@ -0,0 +1,164 @@
+/**
+ * Development Eval Workflow Helpers
+ * Version: 0.1.0
+ */
+const NON_INTERFERENCE_RULES = [
+    'Development evals are additive and never replace formal verification, tests, security review, runtime verification, or watcher checks.',
+    'A passing eval result does not override a failing Semgrep/security outcome.',
+    'A passing eval result does not override build, runtime, or claim-verification failures.',
+];
+function getLatestArtifact(artifacts, output_type) {
+    return artifacts.filter((artifact) => artifact.output_type === output_type).at(-1) ?? null;
+}
+function getPhaseSpecificRequirements(mode, phase) {
+    switch (phase) {
+        case '1':
+            return ['Capture success criteria, non-goals, and failure shape for downstream eval planning.'];
+        case '2':
+            return ['Capture happy-path, edge, failure, and should-not-trigger scenarios for downstream eval planning.'];
+        case '3':
+            return mode === 'plan_required'
+                ? ['Record an eval_plan artifact with capability and regression cases before build.']
+                : ['Define the minimal acceptance/regression case that must exist before Builder completes.'];
+        case '4':
+            return mode === 'plan_required'
+                ? ['Decide the eval_readiness gate before Builder starts.']
+                : ['Verify the minimal L1 development eval obligation is concrete before Builder proceeds.'];
+        case '5':
+            return mode === 'plan_required'
+                ? ['Implement against the eval_plan; eval coverage does not replace real tests.']
+                : ['Before Builder completes, ensure at least one minimal acceptance or regression case exists.'];
+        case '6':
+            return ['Record an eval_run artifact; failing development evals do not override security-review blockers.'];
+        case '7':
+            return ['Resolve any partial eval state with observable runtime or end-state verification.'];
+        case '9':
+            return ['Archive the relevant eval summary when present.'];
+        default:
+            return [];
+    }
+}
+function getExpectedArtifacts(mode, phase, latest_run) {
+    switch (phase) {
+        case '3':
+            return mode === 'plan_required' ? ['eval_plan'] : [];
+        case '6':
+            return ['eval_run'];
+        case '7':
+            return getEvalRunStatus(latest_run) === 'partial' ? ['eval_run'] : [];
+        default:
+            return [];
+    }
+}
+function getExpectedGate(mode, phase) {
+    return phase === '4' && mode === 'plan_required' ? 'eval_readiness' : null;
+}
+function toPhaseNumber(phase) {
+    return Number.parseInt(phase, 10);
+}
+function getLatestOpenReadinessGate(open_gate_records) {
+    return open_gate_records
+        .filter((gate) => gate.gate_name === 'eval_readiness')
+        .sort((left, right) => {
+        const timestamp_delta = new Date(right.approved_at).getTime() - new Date(left.approved_at).getTime();
+        if (timestamp_delta !== 0) {
+            return timestamp_delta;
+        }
+        return toPhaseNumber(right.phase) - toPhaseNumber(left.phase);
+    })
+        .at(0) ?? null;
+}
+function getEvalRunStatus(latest_run) {
+    if (latest_run == null || latest_run.content == null || typeof latest_run.content !== 'object') {
+        return null;
+    }
+    const status = latest_run.content.status;
+    return typeof status === 'string' ? status : null;
+}
+function buildStatusSummary(mode, phase, latest_plan, latest_run, open_readiness_gate) {
+    const summary = [];
+    const phase_number = toPhaseNumber(phase);
+    if (mode === 'plan_required' && phase_number >= 3 && latest_plan == null) {
+        summary.push('No eval_plan artifact has been recorded yet.');
+    }
+    if (latest_plan != null) {
+        summary.push(`Latest eval_plan recorded by ${latest_plan.created_by} at ${latest_plan.created_at}.`);
+    }
+    const latest_run_status = getEvalRunStatus(latest_run);
+    if (phase_number >= 6 && latest_run == null) {
+        summary.push('No eval_run artifact has been recorded yet.');
+    }
+    else if (latest_run != null) {
+        summary.push(latest_run_status == null
+            ? `Latest eval_run recorded by ${latest_run.created_by} at ${latest_run.created_at}.`
+            : `Latest eval_run status is ${latest_run_status}.`);
+    }
+    if (phase === '7' && latest_run_status === 'partial') {
+        summary.push('Integrator must resolve the partial eval_run before Release.');
+    }
+    if (open_readiness_gate != null) {
+        summary.push(`Open eval_readiness gate is ${open_readiness_gate.status} in phase ${open_readiness_gate.phase}.`);
+    }
+    return summary;
+}
+function buildHarnessPromptBlock(mode, phase, latest_plan, latest_run, open_readiness_gate) {
+    const lines = [];
+    if (phase === '3' && mode === 'plan_required') {
+        lines.push('Development Evals are required: produce an `eval_plan` artifact with capability and regression cases before handoff.');
+    }
+    if (phase === '4' && mode === 'plan_required') {
+        lines.push('Development Evals are required: decide the `eval_readiness` gate explicitly before Builder starts.');
+        lines.push('Reject eval plans that are ambiguous, path-rigid, or missing regression coverage for bug fixes.');
+    }
+    if (phase === '5') {
+        lines.push(latest_plan == null && mode === 'plan_required'
+            ? 'Development Evals are required: no `eval_plan` is visible, so block and escalate instead of guessing.'
+            : open_readiness_gate != null
+                ? `Development Evals are required: the open \`eval_readiness\` gate is ${open_readiness_gate.status}. Respect that gate and escalate instead of bypassing it.`
+                : 'Development Evals guide implementation, but they do not replace real tests, build checks, or other review steps.');
+    }
+    if (phase === '6') {
+        lines.push('Development Evals are required here: record an `eval_run` artifact after review-time execution.');
+        lines.push('A passing `eval_run` never overrides failing security findings.');
+    }
+    if (phase === '7') {
+        lines.push(getEvalRunStatus(latest_run) === 'partial'
+            ? 'The latest `eval_run` is partial: resolve it with runtime/end-state evidence and record an updated `eval_run`.'
+            : 'If runtime verification materially changes development-eval confidence, record an updated `eval_run`.');
+    }
+    if (lines.length > 0) {
+        lines.push('Development Evals are additive only; they never replace formal verification, Semgrep, tests, runtime verification, or watcher checks.');
+    }
+    return lines;
+}
+export function getDevelopmentEvalMode(feature) {
+    return feature.complexity_level === 1 ? 'l1_minimal' : 'plan_required';
+}
+export function buildDevelopmentEvalContext(feature, phase, artifacts, open_gate_records) {
+    const mode = getDevelopmentEvalMode(feature);
+    const latest_plan = getLatestArtifact(artifacts, 'eval_plan');
+    const latest_run = getLatestArtifact(artifacts, 'eval_run');
+    const open_readiness_gate = getLatestOpenReadinessGate(open_gate_records);
+    return {
+        mode,
+        latest_plan,
+        latest_run,
+        expected_artifacts: getExpectedArtifacts(mode, phase, latest_run),
+        expected_gate: getExpectedGate(mode, phase),
+        open_readiness_gate,
+        requirements: getPhaseSpecificRequirements(mode, phase),
+        status_summary: buildStatusSummary(mode, phase, latest_plan, latest_run, open_readiness_gate),
+        harness_prompt_block: buildHarnessPromptBlock(mode, phase, latest_plan, latest_run, open_readiness_gate),
+        non_interference_rules: NON_INTERFERENCE_RULES,
+    };
+}
+export function appendDevelopmentEvalChecks(base_checks, phase) {
+    if (phase === '6') {
+        return [...base_checks, 'development eval review'];
+    }
+    if (phase === '7') {
+        return [...base_checks, 'development eval runtime resolution'];
+    }
+    return base_checks;
+}
+//# sourceMappingURL=development-evals.js.map

package/dist/domain/development-evals.js.map

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

package/dist/domain/matching.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Domain Matching
+ * Version: 0.1.0
+ */
+import type { DomainMatch, KnowledgeDomain } from '../types.js';
+export declare function normalizeTerm(term: string): string;
+export declare function matchDomains(tags: string[], domains: KnowledgeDomain[]): DomainMatch[];
+//# sourceMappingURL=matching.d.ts.map

package/dist/domain/matching.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matching.d.ts","sourceRoot":"","sources":["../../src/domain/matching.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEhE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,WAAW,EAAE,CAiBtF"}

package/dist/domain/matching.js

@@ -0,0 +1,24 @@
+/**
+ * Domain Matching
+ * Version: 0.1.0
+ */
+export function normalizeTerm(term) {
+    return term.toLowerCase().replace(/[.\-_\s]/g, '');
+}
+export function matchDomains(tags, domains) {
+    if (tags.length === 0) {
+        return [];
+    }
+    const normalized_tags = new Set(tags.map(normalizeTerm));
+    return domains
+        .map((domain) => {
+        const strong = domain.strong_keywords.filter((k) => normalized_tags.has(normalizeTerm(k)));
+        const weak = domain.weak_keywords.filter((k) => normalized_tags.has(normalizeTerm(k)));
+        const relevance = (strong.length + weak.length) / Math.max(1, normalized_tags.size);
+        const persisted = strong.length >= 1 && relevance >= 0.60;
+        return { domain, relevance, strong_matches: strong, weak_matches: weak, persisted };
+    })
+        .filter((m) => m.relevance >= 0.30)
+        .sort((a, b) => b.relevance - a.relevance);
+}
+//# sourceMappingURL=matching.js.map

package/dist/domain/matching.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matching.js","sourceRoot":"","sources":["../../src/domain/matching.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAc,EAAE,OAA0B;IACrE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;IAEzD,OAAO,OAAO;SACX,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACd,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3F,MAAM,IAAI,GAAG,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACvF,MAAM,SAAS,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC;QACpF,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,SAAS,IAAI,IAAI,CAAC;QAC1D,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IACtF,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC;SAClC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;AAC/C,CAAC"}

package/dist/domain/phases.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Odin Phase Contracts
+ * Version: 0.1.0
+ */
+import type { PhaseAgentInstructions, PhaseContract, PhaseId } from '../types.js';
+export declare function getPhaseContract(phase: PhaseId): PhaseContract;
+export declare function getPhaseAgentInstructions(phase: PhaseId): PhaseAgentInstructions;
+export declare function getNextPhaseId(phase: PhaseId): PhaseId | null;
+export declare function isWatchedPhase(phase: PhaseId): boolean;
+//# sourceMappingURL=phases.d.ts.map

package/dist/domain/phases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phases.d.ts","sourceRoot":"","sources":["../../src/domain/phases.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAuJlF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAE9D;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAEhF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAG7D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEtD"}

package/dist/domain/phases.js

@@ -0,0 +1,165 @@
+/**
+ * Odin Phase Contracts
+ * Version: 0.1.0
+ */
+const PHASE_CONTRACTS = {
+    '0': {
+        id: '0',
+        name: 'Planning',
+        purpose: 'Establish the feature request and prepare the workflow entry point.',
+        definition_of_done: ['Feature request understood', 'Next phase identified'],
+        required_artifacts: [],
+        allowed_next_phases: ['1'],
+    },
+    '1': {
+        id: '1',
+        name: 'Product',
+        purpose: 'Capture the product requirements for the feature.',
+        definition_of_done: ['PRD or exemption recorded', 'Success / non-goals / failure shape captured'],
+        required_artifacts: ['prd'],
+        allowed_next_phases: ['2'],
+    },
+    '2': {
+        id: '2',
+        name: 'Discovery',
+        purpose: 'Gather requirements, context, and technical constraints.',
+        definition_of_done: ['Requirements recorded', 'Eval-relevant scenarios captured'],
+        required_artifacts: ['requirements'],
+        allowed_next_phases: ['3'],
+    },
+    '3': {
+        id: '3',
+        name: 'Architect',
+        purpose: 'Produce the technical spec and task shape.',
+        definition_of_done: ['Spec recorded', 'Tasks recorded', 'Eval plan recorded when required'],
+        required_artifacts: ['spec', 'tasks'],
+        allowed_next_phases: ['4'],
+    },
+    '4': {
+        id: '4',
+        name: 'Guardian',
+        purpose: 'Review the plan for correctness, quality, and risk before build.',
+        definition_of_done: ['Review recorded', 'Eval readiness decided when required'],
+        required_artifacts: ['review'],
+        allowed_next_phases: ['5'],
+    },
+    '5': {
+        id: '5',
+        name: 'Builder',
+        purpose: 'Implement the approved specification.',
+        definition_of_done: ['Implementation completed', 'Build/test obligations met'],
+        required_artifacts: ['spec', 'tasks'],
+        allowed_next_phases: ['6'],
+    },
+    '6': {
+        id: '6',
+        name: 'Reviewer',
+        purpose: 'Run security and unit-test quality review before integration.',
+        definition_of_done: ['Security review completed', 'Test quality evaluation completed', 'Eval run recorded when required'],
+        required_artifacts: ['review'],
+        allowed_next_phases: ['7'],
+    },
+    '7': {
+        id: '7',
+        name: 'Integrator',
+        purpose: 'Validate build/runtime behavior and final integration correctness.',
+        definition_of_done: ['Integration validation complete', 'Partial eval state resolved when required'],
+        required_artifacts: ['spec', 'tasks'],
+        allowed_next_phases: ['8'],
+    },
+    '8': {
+        id: '8',
+        name: 'Documenter',
+        purpose: 'Update docs and finalize implementation notes.',
+        definition_of_done: ['Documentation notes recorded'],
+        required_artifacts: ['documentation'],
+        allowed_next_phases: ['9'],
+    },
+    '9': {
+        id: '9',
+        name: 'Release',
+        purpose: 'Prepare the feature for PR, archival, and completion.',
+        definition_of_done: ['Release notes recorded', 'Feature artifacts archived via odin.archive_feature_release'],
+        required_artifacts: ['release_notes'],
+        allowed_next_phases: ['10'],
+    },
+    '10': {
+        id: '10',
+        name: 'Complete',
+        purpose: 'The feature is fully complete.',
+        definition_of_done: ['Feature completed'],
+        required_artifacts: [],
+        allowed_next_phases: [],
+    },
+};
+const PHASE_AGENT_INSTRUCTIONS = {
+    '0': {
+        name: 'planning-agent',
+        role_summary: 'Translate the request into a workflow entry point.',
+        constraints: ['Do not skip the Product phase.'],
+    },
+    '1': {
+        name: 'product-agent',
+        role_summary: 'Create a product-ready PRD or exemption.',
+        constraints: ['Do not leak implementation details into the PRD.'],
+    },
+    '2': {
+        name: 'discovery-agent',
+        role_summary: 'Gather concrete requirements and technical context.',
+        constraints: ['Read existing artifacts before adding new assumptions.'],
+    },
+    '3': {
+        name: 'architect-agent',
+        role_summary: 'Turn the requirements into an implementation plan.',
+        constraints: ['Spec-first: do not implement code here.', 'Record eval planning when required.'],
+    },
+    '4': {
+        name: 'guardian-agent',
+        role_summary: 'Review for quality, risk, and readiness to build.',
+        constraints: ['Do not approve weak or ambiguous specs.', 'Development eval readiness never overrides formal verification or other gates.'],
+    },
+    '5': {
+        name: 'builder-agent',
+        role_summary: 'Implement the approved plan with high code quality.',
+        constraints: ['Emit watched-phase claims when required.'],
+    },
+    '6': {
+        name: 'reviewer-agent',
+        role_summary: 'Run security and unit-test quality checks and summarize the result.',
+        constraints: ['High and critical findings block progression.', 'Weak or missing tests send the feature back to Builder.', 'Passing eval runs do not override security failures.'],
+    },
+    '7': {
+        name: 'integrator-agent',
+        role_summary: 'Verify integrated behavior beyond compile/build success.',
+        constraints: ['Runtime validation matters, not just build success.', 'Resolve any partial eval state with observable end-state evidence.'],
+    },
+    '8': {
+        name: 'documenter-agent',
+        role_summary: 'Record the docs and operational notes needed for the feature.',
+        constraints: ['Capture changes while they are fresh.'],
+    },
+    '9': {
+        name: 'release-agent',
+        role_summary: 'Prepare PR, archival, and release metadata.',
+        constraints: ['Agents never merge; humans decide merges.'],
+    },
+    '10': {
+        name: 'complete-agent',
+        role_summary: 'The feature is complete and available for historical inspection.',
+        constraints: ['No further forward transitions exist.'],
+    },
+};
+export function getPhaseContract(phase) {
+    return PHASE_CONTRACTS[phase];
+}
+export function getPhaseAgentInstructions(phase) {
+    return PHASE_AGENT_INSTRUCTIONS[phase];
+}
+export function getNextPhaseId(phase) {
+    const allowed_next_phases = PHASE_CONTRACTS[phase].allowed_next_phases;
+    return allowed_next_phases[0] ?? null;
+}
+export function isWatchedPhase(phase) {
+    return phase === '5' || phase === '7' || phase === '9';
+}
+//# sourceMappingURL=phases.js.map

package/dist/domain/phases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phases.js","sourceRoot":"","sources":["../../src/domain/phases.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,eAAe,GAAmC;IACtD,GAAG,EAAE;QACH,EAAE,EAAE,GAAG;QACP,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,qEAAqE;QAC9E,kBAAkB,EAAE,CAAC,4BAA4B,EAAE,uBAAuB,CAAC;QAC3E,kBAAkB,EAAE,EAAE;QACtB,mBAAmB,EAAE,CAAC,GAAG,CAAC;KAC3B;IACD,GAAG,EAAE;QACH,EAAE,EAAE,GAAG;QACP,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,mDAAmD;QAC5D,kBAAkB,EAAE,CAAC,2BAA2B,EAAE,8CAA8C,CAAC;QACjG,kBAAkB,EAAE,CAAC,KAAK,CAAC;QAC3B,mBAAmB,EAAE,CAAC,GAAG,CAAC;KAC3B;IACD,GAAG,EAAE;QACH,EAAE,EAAE,GAAG;QACP,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,0DAA0D;QACnE,kBAAkB,EAAE,CAAC,uBAAuB,EAAE,kCAAkC,CAAC;QACjF,kBAAkB,EAAE,CAAC,cAAc,CAAC;QACpC,mBAAmB,EAAE,CAAC,GAAG,CAAC;KAC3B;IACD,GAAG,EAAE;QACH,EAAE,EAAE,GAAG;QACP,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,4CAA4C;QACrD,kBAAkB,EAAE,CAAC,eAAe,EAAE,gBAAgB,EAAE,kCAAkC,CAAC;QAC3F,kBAAkB,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;QACrC,mBAAmB,EAAE,CAAC,GAAG,CAAC;KAC3B;IACD,GAAG,EAAE;QACH,EAAE,EAAE,GAAG;QACP,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,kEAAkE;QAC3E,kBAAkB,EAAE,CAAC,iBAAiB,EAAE,sCAAsC,CAAC;QAC/E,kBAAkB,EAAE,CAAC,QAAQ,CAAC;QAC9B,mBAAmB,EAAE,CAAC,GAAG,CAAC;KAC3B;IACD,GAAG,EAAE;QACH,EAAE,EAAE,GAAG;QACP,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,uCAAuC;QAChD,kBAAkB,EAAE,CAAC,0BAA0B,EAAE,4BAA4B,CAAC;QAC9E,kBAAkB,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;QACrC,mBAAmB,EAAE,CAAC,GAAG,CAAC;KAC3B;IACD,GAAG,EAAE;QACH,EAAE,EAAE,GAAG;QACP,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,+DAA+D;QACxE,kBAAkB,EAAE,CAAC,2BAA2B,EAAE,mCAAmC,EAAE,iCAAiC,CAAC;QACzH,kBAAkB,EAAE,CAAC,QAAQ,CAAC;QAC9B,mBAAmB,EAAE,CAAC,GAAG,CAAC;KAC3B;IACD,GAAG,EAAE;QACH,EAAE,EAAE,GAAG;QACP,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,oEAAoE;QAC7E,kBAAkB,EAAE,CAAC,iCAAiC,EAAE,2CAA2C,CAAC;QACpG,kBAAkB,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;QACrC,mBAAmB,EAAE,CAAC,GAAG,CAAC;KAC3B;IACD,GAAG,EAAE;QACH,EAAE,EAAE,GAAG;QACP,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,gDAAgD;QACzD,kBAAkB,EAAE,CAAC,8BAA8B,CAAC;QACpD,kBAAkB,EAAE,CAAC,eAAe,CAAC;QACrC,mBAAmB,EAAE,CAAC,GAAG,CAAC;KAC3B;IACD,GAAG,EAAE;QACH,EAAE,EAAE,GAAG;QACP,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,uDAAuD;QAChE,kBAAkB,EAAE,CAAC,wBAAwB,EAAE,6DAA6D,CAAC;QAC7G,kBAAkB,EAAE,CAAC,eAAe,CAAC;QACrC,mBAAmB,EAAE,CAAC,IAAI,CAAC;KAC5B;IACD,IAAI,EAAE;QACJ,EAAE,EAAE,IAAI;QACR,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,gCAAgC;QACzC,kBAAkB,EAAE,CAAC,mBAAmB,CAAC;QACzC,kBAAkB,EAAE,EAAE;QACtB,mBAAmB,EAAE,EAAE;KACxB;CACF,CAAC;AAEF,MAAM,wBAAwB,GAA4C;IACxE,GAAG,EAAE;QACH,IAAI,EAAE,gBAAgB;QACtB,YAAY,EAAE,oDAAoD;QAClE,WAAW,EAAE,CAAC,gCAAgC,CAAC;KAChD;IACD,GAAG,EAAE;QACH,IAAI,EAAE,eAAe;QACrB,YAAY,EAAE,0CAA0C;QACxD,WAAW,EAAE,CAAC,kDAAkD,CAAC;KAClE;IACD,GAAG,EAAE;QACH,IAAI,EAAE,iBAAiB;QACvB,YAAY,EAAE,qDAAqD;QACnE,WAAW,EAAE,CAAC,wDAAwD,CAAC;KACxE;IACD,GAAG,EAAE;QACH,IAAI,EAAE,iBAAiB;QACvB,YAAY,EAAE,oDAAoD;QAClE,WAAW,EAAE,CAAC,yCAAyC,EAAE,qCAAqC,CAAC;KAChG;IACD,GAAG,EAAE;QACH,IAAI,EAAE,gBAAgB;QACtB,YAAY,EAAE,mDAAmD;QACjE,WAAW,EAAE,CAAC,yCAAyC,EAAE,gFAAgF,CAAC;KAC3I;IACD,GAAG,EAAE;QACH,IAAI,EAAE,eAAe;QACrB,YAAY,EAAE,qDAAqD;QACnE,WAAW,EAAE,CAAC,0CAA0C,CAAC;KAC1D;IACD,GAAG,EAAE;QACH,IAAI,EAAE,gBAAgB;QACtB,YAAY,EAAE,qEAAqE;QACnF,WAAW,EAAE,CAAC,+CAA+C,EAAE,yDAAyD,EAAE,sDAAsD,CAAC;KAClL;IACD,GAAG,EAAE;QACH,IAAI,EAAE,kBAAkB;QACxB,YAAY,EAAE,0DAA0D;QACxE,WAAW,EAAE,CAAC,qDAAqD,EAAE,oEAAoE,CAAC;KAC3I;IACD,GAAG,EAAE;QACH,IAAI,EAAE,kBAAkB;QACxB,YAAY,EAAE,+DAA+D;QAC7E,WAAW,EAAE,CAAC,uCAAuC,CAAC;KACvD;IACD,GAAG,EAAE;QACH,IAAI,EAAE,eAAe;QACrB,YAAY,EAAE,6CAA6C;QAC3D,WAAW,EAAE,CAAC,2CAA2C,CAAC;KAC3D;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,gBAAgB;QACtB,YAAY,EAAE,kEAAkE;QAChF,WAAW,EAAE,CAAC,uCAAuC,CAAC;KACvD;CACF,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAAc;IACtD,OAAO,wBAAwB,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,MAAM,mBAAmB,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,mBAAmB,CAAC;IACvE,OAAO,mBAAmB,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,GAAG,CAAC;AACzD,CAAC"}

package/dist/domain/quality-gates.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Quality Gate Helpers
+ * Version: 0.1.0
+ */
+import type { QualityGateRecord } from '../types.js';
+export declare function formatOpenGateSummary(gate: QualityGateRecord): string;
+//# sourceMappingURL=quality-gates.d.ts.map

package/dist/domain/quality-gates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-gates.d.ts","sourceRoot":"","sources":["../../src/domain/quality-gates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAErE"}

package/dist/domain/quality-gates.js

@@ -0,0 +1,8 @@
+/**
+ * Quality Gate Helpers
+ * Version: 0.1.0
+ */
+export function formatOpenGateSummary(gate) {
+    return `${gate.gate_name} [phase ${gate.phase}] (${gate.status})`;
+}
+//# sourceMappingURL=quality-gates.js.map

package/dist/domain/quality-gates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-gates.js","sourceRoot":"","sources":["../../src/domain/quality-gates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,UAAU,qBAAqB,CAAC,IAAuB;IAC3D,OAAO,GAAG,IAAI,CAAC,SAAS,WAAW,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,MAAM,GAAG,CAAC;AACpE,CAAC"}

package/dist/domain/resonance.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Resonance Scoring
+ * Version: 0.1.0
+ *
+ * Retrieval-time ranking signal for related learnings.
+ * Resonance is computed in-memory and NEVER written to confidence_score.
+ */
+export interface ResonanceInput {
+    id: string;
+    category: string;
+    confidence_score: number;
+    source_feature_id: string;
+    shared_domains: string[];
+    created_at: string;
+}
+export interface ResonanceScore {
+    learning_id: string;
+    density: number;
+    corroboration: number;
+    recency: number;
+    combined: number;
+}
+/**
+ * Compute resonance scores for a set of related learnings.
+ * Returns scores sorted by combined resonance (descending).
+ *
+ * Weights: density 0.3, corroboration 0.4, recency 0.3
+ * These are tuned for knowledge retrieval — corroboration (agreement
+ * from different features) is weighted highest as it's the strongest
+ * signal that a learning is broadly applicable.
+ */
+export declare function computeResonance(learnings: ResonanceInput[], now?: Date): ResonanceScore[];
+//# sourceMappingURL=resonance.d.ts.map

package/dist/domain/resonance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resonance.d.ts","sourceRoot":"","sources":["../../src/domain/resonance.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAqED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,cAAc,EAAE,EAC3B,GAAG,CAAC,EAAE,IAAI,GACT,cAAc,EAAE,CAwBlB"}

package/dist/domain/resonance.js

@@ -0,0 +1,100 @@
+/**
+ * Resonance Scoring
+ * Version: 0.1.0
+ *
+ * Retrieval-time ranking signal for related learnings.
+ * Resonance is computed in-memory and NEVER written to confidence_score.
+ */
+/**
+ * Compute domain density — how many learnings share each domain.
+ * Returns a map of domain key → count of learnings in that domain.
+ */
+function computeDomainDensity(learnings) {
+    const density = new Map();
+    for (const learning of learnings) {
+        for (const domain of learning.shared_domains) {
+            density.set(domain, (density.get(domain) ?? 0) + 1);
+        }
+    }
+    return density;
+}
+/**
+ * Density score: average density across this learning's shared domains,
+ * normalized to 0–1 using log scaling (caps at density 20+).
+ */
+function scoreDensity(learning, density_map) {
+    if (learning.shared_domains.length === 0) {
+        return 0;
+    }
+    let total = 0;
+    for (const domain of learning.shared_domains) {
+        total += density_map.get(domain) ?? 0;
+    }
+    const avg = total / learning.shared_domains.length;
+    return Math.min(1, Math.log2(avg + 1) / Math.log2(21));
+}
+/**
+ * Corroboration score: how many other learnings from DIFFERENT features
+ * share at least one domain AND the same category.
+ * Normalized to 0–1 (caps at 5 corroborating learnings).
+ */
+function scoreCorroboration(learning, all_learnings) {
+    const domain_set = new Set(learning.shared_domains);
+    let count = 0;
+    for (const other of all_learnings) {
+        if (other.id === learning.id)
+            continue;
+        if (other.source_feature_id === learning.source_feature_id)
+            continue;
+        if (other.category !== learning.category)
+            continue;
+        const overlaps = other.shared_domains.some((d) => domain_set.has(d));
+        if (overlaps) {
+            count++;
+        }
+    }
+    return Math.min(1, count / 5);
+}
+/**
+ * Recency score: exponential decay based on age in days.
+ * Half-life of 30 days — a learning 30 days old scores 0.5.
+ */
+function scoreRecency(learning, now) {
+    const created = new Date(learning.created_at);
+    const age_ms = now.getTime() - created.getTime();
+    const age_days = Math.max(0, age_ms / (1000 * 60 * 60 * 24));
+    const half_life = 30;
+    return Math.pow(0.5, age_days / half_life);
+}
+/**
+ * Compute resonance scores for a set of related learnings.
+ * Returns scores sorted by combined resonance (descending).
+ *
+ * Weights: density 0.3, corroboration 0.4, recency 0.3
+ * These are tuned for knowledge retrieval — corroboration (agreement
+ * from different features) is weighted highest as it's the strongest
+ * signal that a learning is broadly applicable.
+ */
+export function computeResonance(learnings, now) {
+    if (learnings.length === 0) {
+        return [];
+    }
+    const reference = now ?? new Date();
+    const density_map = computeDomainDensity(learnings);
+    return learnings
+        .map((learning) => {
+        const density = scoreDensity(learning, density_map);
+        const corroboration = scoreCorroboration(learning, learnings);
+        const recency = scoreRecency(learning, reference);
+        const combined = 0.3 * density + 0.4 * corroboration + 0.3 * recency;
+        return {
+            learning_id: learning.id,
+            density: Math.round(density * 1000) / 1000,
+            corroboration: Math.round(corroboration * 1000) / 1000,
+            recency: Math.round(recency * 1000) / 1000,
+            combined: Math.round(combined * 1000) / 1000,
+        };
+    })
+        .sort((a, b) => b.combined - a.combined);
+}
+//# sourceMappingURL=resonance.js.map

package/dist/domain/resonance.js.map

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

package/dist/domain/tasks.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Task Artifact Helpers
+ * Version: 0.1.0
+ */
+export declare function completeTaskArtifactContent(content: unknown): {
+    changed: boolean;
+    content: unknown;
+};
+//# sourceMappingURL=tasks.d.ts.map

package/dist/domain/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/domain/tasks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkCH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CA8BpG"}

package/dist/domain/tasks.js

@@ -0,0 +1,57 @@
+/**
+ * Task Artifact Helpers
+ * Version: 0.1.0
+ */
+function isRecord(value) {
+    return value != null && typeof value === 'object' && !Array.isArray(value);
+}
+function normalizeTaskStatus(status) {
+    if (status === 'completed' || status === 'done') {
+        return 'completed';
+    }
+    if (status === 'in_progress' || status === 'in-progress') {
+        return 'in_progress';
+    }
+    return 'pending';
+}
+function completeTaskItem(value) {
+    if (!isRecord(value)) {
+        return { changed: false, value };
+    }
+    const previous_status = normalizeTaskStatus(value.status);
+    if (previous_status === 'completed') {
+        return { changed: false, value: { ...value, status: 'completed' } };
+    }
+    return {
+        changed: true,
+        value: { ...value, status: 'completed' },
+    };
+}
+export function completeTaskArtifactContent(content) {
+    if (Array.isArray(content)) {
+        let changed = false;
+        const next = content.map((item) => {
+            const result = completeTaskItem(item);
+            changed = changed || result.changed;
+            return result.value;
+        });
+        return { changed, content: next };
+    }
+    if (isRecord(content) && Array.isArray(content.tasks)) {
+        let changed = false;
+        const tasks = content.tasks.map((item) => {
+            const result = completeTaskItem(item);
+            changed = changed || result.changed;
+            return result.value;
+        });
+        return {
+            changed,
+            content: {
+                ...content,
+                tasks,
+            },
+        };
+    }
+    return { changed: false, content };
+}
+//# sourceMappingURL=tasks.js.map