@plazmodium/odin 0.3.2-beta

package/dist/tools/archive-feature-release.js

@@ -0,0 +1,182 @@
+/**
+ * Archive Feature Release Tool
+ * Version: 0.1.0
+ */
+import { createErrorResult, createTextResult } from '../utils.js';
+function titleize(value) {
+    return value
+        .replace(/_/g, ' ')
+        .split(' ')
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join(' ');
+}
+function formatScalar(value) {
+    if (value == null)
+        return 'null';
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return String(value);
+    return JSON.stringify(value, null, 2);
+}
+function tryParseJson(value) {
+    const trimmed = value.trim();
+    if ((trimmed.startsWith('{') && trimmed.endsWith('}')) || (trimmed.startsWith('[') && trimmed.endsWith(']'))) {
+        try {
+            return JSON.parse(trimmed);
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}
+function renderMarkdown(value, depth = 2) {
+    if (value == null) {
+        return '_No content provided._';
+    }
+    if (typeof value === 'string') {
+        if (value.trim().length === 0)
+            return '_No content provided._';
+        const parsed = tryParseJson(value);
+        if (parsed != null)
+            return renderMarkdown(parsed, depth);
+        return value;
+    }
+    if (typeof value === 'number' || typeof value === 'boolean') {
+        return String(value);
+    }
+    if (Array.isArray(value)) {
+        if (value.length === 0) {
+            return '_None_';
+        }
+        return value
+            .map((item, index) => {
+            if (item != null && typeof item === 'object' && !Array.isArray(item)) {
+                const object = item;
+                const keys = Object.keys(object);
+                const isMultiField = keys.length > 1;
+                const prefix = isMultiField ? `**${index + 1}.** ` : '';
+                const lines = Object.entries(object).map(([key, nested]) => {
+                    if (nested != null && typeof nested === 'object') {
+                        const nestedBody = renderMarkdown(nested, depth + 1)
+                            .split('\n')
+                            .map((line) => `  ${line}`)
+                            .join('\n');
+                        return `- **${titleize(key)}**:\n${nestedBody}`;
+                    }
+                    return `- **${titleize(key)}**: ${formatScalar(nested)}`;
+                });
+                return (prefix ? `${prefix}\n` : '') + lines.join('\n');
+            }
+            return `- ${formatScalar(item)}`;
+        })
+            .join('\n\n');
+    }
+    const object = value;
+    const sections = Object.entries(object).map(([key, nested]) => {
+        const heading = `${'#'.repeat(Math.min(depth, 6))} ${titleize(key)}`;
+        return `${heading}\n\n${renderMarkdown(nested, depth + 1)}`;
+    });
+    return sections.join('\n\n');
+}
+function artifactToArchiveFile(artifact) {
+    const title = titleize(artifact.output_type);
+    const body = renderMarkdown(artifact.content);
+    return {
+        name: `${artifact.output_type}.md`,
+        content: `# ${title}\n\n${body}\n`,
+    };
+}
+const DEFAULT_ARCHIVE_OUTPUT_TYPES = [
+    'prd',
+    'requirements',
+    'spec',
+    'tasks',
+    'review',
+    'documentation',
+    'release_notes',
+];
+function selectArtifacts(artifacts, include_output_types) {
+    const selected = new Map();
+    for (const output_type of include_output_types) {
+        const matching = artifacts.filter((artifact) => artifact.output_type === output_type);
+        const latest = matching.at(-1);
+        if (latest != null) {
+            selected.set(output_type, latest);
+        }
+    }
+    return Array.from(selected.values());
+}
+export async function autoArchiveFeature(workflow_state, archive_adapter, feature_id, summary, archived_by) {
+    const artifacts = await workflow_state.listPhaseArtifacts(feature_id);
+    const selected = selectArtifacts(artifacts, DEFAULT_ARCHIVE_OUTPUT_TYPES);
+    if (selected.length === 0) {
+        return null;
+    }
+    const files = selected.map(artifactToArchiveFile);
+    const upload = await archive_adapter.uploadArchive({ feature_id, files });
+    if (upload.success !== true) {
+        return null;
+    }
+    const spec_snapshot = selected.find((artifact) => artifact.output_type === 'spec')?.content ?? {};
+    await archive_adapter.recordArchive({
+        feature_id,
+        storage_path: upload.storage_path,
+        summary,
+        files_archived: upload.files_uploaded,
+        total_size_bytes: upload.total_size_bytes,
+        spec_snapshot,
+        archived_by,
+    });
+    return { files_archived: upload.files_uploaded.length, storage_path: upload.storage_path };
+}
+export async function handleArchiveFeatureRelease(workflow_state, archive_adapter, input) {
+    if (archive_adapter == null) {
+        return createErrorResult('Archive adapter is unavailable. Configure Supabase archival before using this tool.', { feature_id: input.feature_id });
+    }
+    const feature = await workflow_state.getFeature(input.feature_id);
+    if (feature == null) {
+        return createErrorResult(`Feature ${input.feature_id} was not found.`, {
+            feature_id: input.feature_id,
+        });
+    }
+    const artifacts = await workflow_state.listPhaseArtifacts(input.feature_id);
+    const selected = selectArtifacts(artifacts, input.include_output_types);
+    if (selected.length === 0) {
+        return createErrorResult(`No matching phase artifacts were found for feature ${input.feature_id}.`, {
+            feature_id: input.feature_id,
+            include_output_types: input.include_output_types,
+        });
+    }
+    const files = selected.map(artifactToArchiveFile);
+    const upload = await archive_adapter.uploadArchive({
+        feature_id: input.feature_id,
+        files,
+    });
+    if (upload.success !== true) {
+        return createErrorResult(`Archive upload failed for feature ${input.feature_id}.`, {
+            feature_id: input.feature_id,
+            upload_errors: upload.errors ?? [],
+        });
+    }
+    const spec_snapshot = selected.find((artifact) => artifact.output_type === 'spec')?.content ?? {};
+    const archive_record = await archive_adapter.recordArchive({
+        feature_id: input.feature_id,
+        storage_path: upload.storage_path,
+        summary: input.summary,
+        files_archived: upload.files_uploaded,
+        total_size_bytes: upload.total_size_bytes,
+        spec_snapshot,
+        release_version: input.release_version,
+        release_notes: input.release_notes,
+        archived_by: input.archived_by,
+    });
+    return createTextResult(`Archived ${upload.files_uploaded.length} file(s) for feature ${input.feature_id}.`, {
+        feature,
+        archive: archive_record,
+        uploaded_files: upload.files_uploaded,
+        upload_errors: upload.errors ?? [],
+    });
+}
+//# sourceMappingURL=archive-feature-release.js.map

package/dist/tools/archive-feature-release.js.map

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

package/dist/tools/capture-learning.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Capture Learning Tool
+ * Version: 0.2.0
+ */
+import type { SkillAdapter } from '../adapters/skills/types.js';
+import type { WorkflowStateAdapter } from '../adapters/workflow-state/types.js';
+import type { CaptureLearningInput } from '../schemas.js';
+export declare function handleCaptureLearning(adapter: WorkflowStateAdapter, skill_adapter: SkillAdapter, input: CaptureLearningInput): Promise<import("../utils.js").ToolResult>;
+//# sourceMappingURL=capture-learning.d.ts.map

package/dist/tools/capture-learning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-learning.d.ts","sourceRoot":"","sources":["../../src/tools/capture-learning.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAEhF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAe1D,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,oBAAoB,EAC7B,aAAa,EAAE,YAAY,EAC3B,KAAK,EAAE,oBAAoB,6CAmD5B"}

package/dist/tools/capture-learning.js

@@ -0,0 +1,53 @@
+/**
+ * Capture Learning Tool
+ * Version: 0.2.0
+ */
+import { matchDomains } from '../domain/matching.js';
+import { createErrorResult, createId, createTextResult } from '../utils.js';
+function formatMatchSummary(match) {
+    return {
+        name: match.domain.name,
+        target_type: match.domain.target_type,
+        target_path: match.domain.target_path,
+        relevance: Math.round(match.relevance * 100) / 100,
+        strong_matches: match.strong_matches,
+        weak_matches: match.weak_matches,
+    };
+}
+export async function handleCaptureLearning(adapter, skill_adapter, input) {
+    const feature = await adapter.getFeature(input.feature_id);
+    if (feature == null) {
+        return createErrorResult(`Feature ${input.feature_id} was not found.`, {
+            feature_id: input.feature_id,
+        });
+    }
+    const learning = await adapter.captureLearning({
+        id: createId('learning'),
+        feature_id: input.feature_id,
+        phase: input.phase,
+        title: input.title,
+        content: input.content,
+        category: input.category,
+        tags: input.domain_tags,
+        created_by: input.created_by,
+        created_at: new Date().toISOString(),
+    });
+    let persisted_domains = [];
+    let suggested_domains = [];
+    if (input.domain_tags.length > 0) {
+        const domains = await skill_adapter.listKnowledgeDomains();
+        const matches = matchDomains(input.domain_tags, domains);
+        const persisted_matches = matches.filter((m) => m.persisted);
+        const suggested_matches = matches.filter((m) => !m.persisted);
+        for (const match of persisted_matches) {
+            await adapter.declarePropagationTarget(learning.id, match.domain.target_type, match.domain.target_path, match.relevance);
+        }
+        persisted_domains = persisted_matches.map(formatMatchSummary);
+        suggested_domains = suggested_matches.map(formatMatchSummary);
+    }
+    return createTextResult(`Captured ${learning.category} learning for feature ${learning.feature_id}.` +
+        (persisted_domains.length > 0
+            ? ` Auto-declared ${persisted_domains.length} propagation target(s).`
+            : ''), { learning, persisted_domains, suggested_domains });
+}
+//# sourceMappingURL=capture-learning.js.map

package/dist/tools/capture-learning.js.map

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

package/dist/tools/explore-knowledge.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Explore Knowledge Tool
+ * Version: 0.1.0
+ */
+import type { SkillAdapter } from '../adapters/skills/types.js';
+import type { WorkflowStateAdapter } from '../adapters/workflow-state/types.js';
+import type { ExploreKnowledgeInput } from '../schemas.js';
+export declare function handleExploreKnowledge(adapter: WorkflowStateAdapter, skill_adapter: SkillAdapter, input: ExploreKnowledgeInput): Promise<import("../utils.js").ToolResult>;
+//# sourceMappingURL=explore-knowledge.d.ts.map

package/dist/tools/explore-knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explore-knowledge.d.ts","sourceRoot":"","sources":["../../src/tools/explore-knowledge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAGhF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAyB3D,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,oBAAoB,EAC7B,aAAa,EAAE,YAAY,EAC3B,KAAK,EAAE,qBAAqB,6CAuJ7B"}

package/dist/tools/explore-knowledge.js

@@ -0,0 +1,142 @@
+/**
+ * Explore Knowledge Tool
+ * Version: 0.1.0
+ */
+import { matchDomains, normalizeTerm } from '../domain/matching.js';
+import { computeResonance } from '../domain/resonance.js';
+import { createTextResult } from '../utils.js';
+export async function handleExploreKnowledge(adapter, skill_adapter, input) {
+    const domains = await skill_adapter.listKnowledgeDomains();
+    // Determine which domains to explore
+    let target_domains;
+    if (input.tags.length > 0) {
+        const matches = matchDomains(input.tags, domains);
+        target_domains = matches.map((m) => m.domain);
+        if (target_domains.length === 0) {
+            return createTextResult(`No knowledge domains matched tags: [${input.tags.join(', ')}].`, {
+                clusters: [],
+                bridges: [],
+                unmatched_tags: input.tags,
+                domain_stats: { total_domains: domains.length, explored: 0, total_learnings: 0 },
+            });
+        }
+    }
+    else {
+        target_domains = domains;
+    }
+    // Collect all learnings across all features via the adapter
+    const all_learnings = await adapter.listAllLearnings({
+        feature_id: input.feature_id,
+        category: input.category,
+        min_confidence: input.min_confidence,
+    });
+    // Match each learning's tags against all domains to build clusters
+    const domain_learnings = new Map();
+    const learning_domains = new Map();
+    for (const learning of all_learnings) {
+        if (learning.tags.length === 0)
+            continue;
+        const matches = matchDomains(learning.tags, target_domains);
+        const matched_domain_ids = [];
+        for (const match of matches) {
+            if (!match.persisted)
+                continue;
+            const existing = domain_learnings.get(match.domain.id) ?? [];
+            existing.push({ learning, relevance: match.relevance });
+            domain_learnings.set(match.domain.id, existing);
+            matched_domain_ids.push(match.domain.id);
+        }
+        if (matched_domain_ids.length > 0) {
+            learning_domains.set(learning.id, matched_domain_ids);
+        }
+    }
+    // Build resonance inputs from learnings that appear in clusters
+    const resonance_inputs = [];
+    const seen_ids = new Set();
+    for (const entries of domain_learnings.values()) {
+        for (const { learning } of entries) {
+            if (seen_ids.has(learning.id))
+                continue;
+            seen_ids.add(learning.id);
+            resonance_inputs.push({
+                id: learning.id,
+                category: learning.category,
+                confidence_score: 0.8,
+                source_feature_id: learning.feature_id,
+                shared_domains: learning_domains.get(learning.id) ?? [],
+                created_at: learning.created_at,
+            });
+        }
+    }
+    const resonance_scores = computeResonance(resonance_inputs);
+    const resonance_map = new Map(resonance_scores.map((s) => [s.learning_id, s]));
+    // Build domain clusters
+    const clusters = [];
+    for (const domain of target_domains) {
+        const entries = domain_learnings.get(domain.id);
+        if (entries == null || entries.length === 0)
+            continue;
+        clusters.push({
+            domain_id: domain.id,
+            domain_name: domain.name,
+            target_type: domain.target_type,
+            target_path: domain.target_path,
+            learnings: entries
+                .map(({ learning }) => ({
+                id: learning.id,
+                title: learning.title,
+                category: learning.category,
+                feature_id: learning.feature_id,
+                resonance: resonance_map.get(learning.id)?.combined ?? 0,
+            }))
+                .sort((a, b) => b.resonance - a.resonance),
+            density: entries.length,
+        });
+    }
+    clusters.sort((a, b) => b.density - a.density);
+    // Build cross-domain bridges (learnings in 2+ domains)
+    const bridges = [];
+    for (const [learning_id, domain_ids] of learning_domains.entries()) {
+        if (domain_ids.length < 2)
+            continue;
+        const learning = all_learnings.find((l) => l.id === learning_id);
+        if (learning == null)
+            continue;
+        bridges.push({
+            learning_id,
+            learning_title: learning.title,
+            domains: domain_ids,
+        });
+    }
+    bridges.sort((a, b) => b.domains.length - a.domains.length);
+    // Find unmatched tags
+    const unmatched_tags = [];
+    if (input.tags.length > 0) {
+        const all_keywords = new Set();
+        for (const domain of target_domains) {
+            for (const k of domain.strong_keywords)
+                all_keywords.add(normalizeTerm(k));
+            for (const k of domain.weak_keywords)
+                all_keywords.add(normalizeTerm(k));
+        }
+        for (const tag of input.tags) {
+            if (!all_keywords.has(normalizeTerm(tag))) {
+                unmatched_tags.push(tag);
+            }
+        }
+    }
+    const total_learnings = seen_ids.size;
+    return createTextResult(`Explored ${clusters.length} knowledge domain(s) containing ${total_learnings} learning(s).` +
+        (bridges.length > 0 ? ` Found ${bridges.length} cross-domain bridge(s).` : '') +
+        (unmatched_tags.length > 0 ? ` Unmatched tags: [${unmatched_tags.join(', ')}].` : ''), {
+        clusters,
+        bridges,
+        unmatched_tags,
+        domain_stats: {
+            total_domains: domains.length,
+            explored: clusters.length,
+            total_learnings,
+        },
+    });
+}
+//# sourceMappingURL=explore-knowledge.js.map

package/dist/tools/explore-knowledge.js.map

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

package/dist/tools/get-claims-needing-review.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Get Claims Needing Review Tool
+ * Version: 0.1.0
+ */
+import type { WorkflowStateAdapter } from '../adapters/workflow-state/types.js';
+import type { GetClaimsNeedingReviewInput } from '../schemas.js';
+export declare function handleGetClaimsNeedingReview(adapter: WorkflowStateAdapter, input: GetClaimsNeedingReviewInput): Promise<import("../utils.js").ToolResult>;
+//# sourceMappingURL=get-claims-needing-review.d.ts.map

package/dist/tools/get-claims-needing-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-claims-needing-review.d.ts","sourceRoot":"","sources":["../../src/tools/get-claims-needing-review.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAGjE,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,oBAAoB,EAC7B,KAAK,EAAE,2BAA2B,6CAoBnC"}

package/dist/tools/get-claims-needing-review.js

@@ -0,0 +1,21 @@
+/**
+ * Get Claims Needing Review Tool
+ * Version: 0.1.0
+ */
+import { createErrorResult, createTextResult } from '../utils.js';
+export async function handleGetClaimsNeedingReview(adapter, input) {
+    if (input.feature_id != null) {
+        const feature = await adapter.getFeature(input.feature_id);
+        if (feature == null) {
+            return createErrorResult(`Feature ${input.feature_id} was not found.`, {
+                feature_id: input.feature_id,
+            });
+        }
+    }
+    const claims = await adapter.listClaimsNeedingReview(input.feature_id);
+    return createTextResult(`Found ${claims.length} claim(s) needing watcher review${input.feature_id == null ? '' : ` for feature ${input.feature_id}`}. The watcher-agent should review each claim and record verdicts with odin.record_watcher_review.`, {
+        feature_id: input.feature_id ?? null,
+        claims,
+    });
+}
+//# sourceMappingURL=get-claims-needing-review.js.map

package/dist/tools/get-claims-needing-review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-claims-needing-review.js","sourceRoot":"","sources":["../../src/tools/get-claims-needing-review.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAElE,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,OAA6B,EAC7B,KAAkC;IAElC,IAAI,KAAK,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC3D,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;YACpB,OAAO,iBAAiB,CAAC,WAAW,KAAK,CAAC,UAAU,iBAAiB,EAAE;gBACrE,UAAU,EAAE,KAAK,CAAC,UAAU;aAC7B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,uBAAuB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAEvE,OAAO,gBAAgB,CACrB,SAAS,MAAM,CAAC,MAAM,mCAAmC,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,KAAK,CAAC,UAAU,EAAE,mGAAmG,EAC9N;QACE,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI;QACpC,MAAM;KACP,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/get-development-eval-status.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Get Development Eval Status Tool
+ * Version: 0.1.0
+ */
+import type { WorkflowStateAdapter } from '../adapters/workflow-state/types.js';
+import type { GetDevelopmentEvalStatusInput } from '../schemas.js';
+export declare function handleGetDevelopmentEvalStatus(adapter: WorkflowStateAdapter, input: GetDevelopmentEvalStatusInput): Promise<import("../utils.js").ToolResult>;
+//# sourceMappingURL=get-development-eval-status.d.ts.map

package/dist/tools/get-development-eval-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-development-eval-status.d.ts","sourceRoot":"","sources":["../../src/tools/get-development-eval-status.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAEhF,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC;AAGnE,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,oBAAoB,EAC7B,KAAK,EAAE,6BAA6B,6CAoDrC"}

package/dist/tools/get-development-eval-status.js

@@ -0,0 +1,49 @@
+/**
+ * Get Development Eval Status Tool
+ * Version: 0.1.0
+ */
+import { buildDevelopmentEvalContext } from '../domain/development-evals.js';
+import { createErrorResult, createTextResult } from '../utils.js';
+export async function handleGetDevelopmentEvalStatus(adapter, input) {
+    const feature = await adapter.getFeature(input.feature_id);
+    if (feature == null) {
+        return createErrorResult(`Feature ${input.feature_id} was not found.`, {
+            feature_id: input.feature_id,
+        });
+    }
+    const [artifacts, open_gate_records] = await Promise.all([
+        adapter.listPhaseArtifacts(input.feature_id),
+        adapter.listOpenGateRecords(input.feature_id),
+    ]);
+    const development_evals = buildDevelopmentEvalContext(feature, feature.current_phase, artifacts, open_gate_records);
+    const eval_plans = artifacts.filter((artifact) => artifact.output_type === 'eval_plan');
+    const eval_runs = artifacts.filter((artifact) => artifact.output_type === 'eval_run');
+    const readiness_gate = development_evals.open_readiness_gate;
+    const text_parts = [
+        `Development eval mode is ${development_evals.mode}.`,
+        development_evals.latest_plan == null ? 'No eval_plan recorded.' : 'Latest eval_plan recorded.',
+        development_evals.latest_run == null ? 'No eval_run recorded.' : 'Latest eval_run recorded.',
+        readiness_gate == null
+            ? 'No open eval_readiness gate.'
+            : `Open eval_readiness gate is ${readiness_gate.status}.`,
+    ];
+    return createTextResult(text_parts.join(' '), {
+        feature: {
+            id: feature.id,
+            name: feature.name,
+            current_phase: feature.current_phase,
+            status: feature.status,
+            complexity_level: feature.complexity_level,
+        },
+        development_evals,
+        history: {
+            eval_plan_count: eval_plans.length,
+            eval_run_count: eval_runs.length,
+            latest_eval_plan: development_evals.latest_plan,
+            latest_eval_run: development_evals.latest_run,
+            recent_eval_plans: eval_plans.slice(-3),
+            recent_eval_runs: eval_runs.slice(-5),
+        },
+    });
+}
+//# sourceMappingURL=get-development-eval-status.js.map

package/dist/tools/get-development-eval-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-development-eval-status.js","sourceRoot":"","sources":["../../src/tools/get-development-eval-status.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAE7E,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAElE,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,OAA6B,EAC7B,KAAoC;IAEpC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC3D,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QACpB,OAAO,iBAAiB,CAAC,WAAW,KAAK,CAAC,UAAU,iBAAiB,EAAE;YACrE,UAAU,EAAE,KAAK,CAAC,UAAU;SAC7B,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,SAAS,EAAE,iBAAiB,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACvD,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,UAAU,CAAC;QAC5C,OAAO,CAAC,mBAAmB,CAAC,KAAK,CAAC,UAAU,CAAC;KAC9C,CAAC,CAAC;IAEH,MAAM,iBAAiB,GAAG,2BAA2B,CACnD,OAAO,EACP,OAAO,CAAC,aAAa,EACrB,SAAS,EACT,iBAAiB,CAClB,CAAC;IAEF,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,WAAW,KAAK,WAAW,CAAC,CAAC;IACxF,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,WAAW,KAAK,UAAU,CAAC,CAAC;IAEtF,MAAM,cAAc,GAAG,iBAAiB,CAAC,mBAAmB,CAAC;IAC7D,MAAM,UAAU,GAAG;QACjB,4BAA4B,iBAAiB,CAAC,IAAI,GAAG;QACrD,iBAAiB,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,4BAA4B;QAC/F,iBAAiB,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,2BAA2B;QAC5F,cAAc,IAAI,IAAI;YACpB,CAAC,CAAC,8BAA8B;YAChC,CAAC,CAAC,+BAA+B,cAAc,CAAC,MAAM,GAAG;KAC5D,CAAC;IAEF,OAAO,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;QAC5C,OAAO,EAAE;YACP,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;SAC3C;QACD,iBAAiB;QACjB,OAAO,EAAE;YACP,eAAe,EAAE,UAAU,CAAC,MAAM;YAClC,cAAc,EAAE,SAAS,CAAC,MAAM;YAChC,gBAAgB,EAAE,iBAAiB,CAAC,WAAW;YAC/C,eAAe,EAAE,iBAAiB,CAAC,UAAU;YAC7C,iBAAiB,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACvC,gBAAgB,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SACtC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/get-feature-status.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Get Feature Status Tool
+ * Version: 0.1.0
+ */
+import type { WorkflowStateAdapter } from '../adapters/workflow-state/types.js';
+import type { GetFeatureStatusInput } from '../schemas.js';
+export declare function handleGetFeatureStatus(adapter: WorkflowStateAdapter, input: GetFeatureStatusInput): Promise<import("../utils.js").ToolResult>;
+//# sourceMappingURL=get-feature-status.d.ts.map

package/dist/tools/get-feature-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-feature-status.d.ts","sourceRoot":"","sources":["../../src/tools/get-feature-status.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAIhF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAG3D,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,oBAAoB,EAC7B,KAAK,EAAE,qBAAqB,6CA4E7B"}

package/dist/tools/get-feature-status.js

@@ -0,0 +1,68 @@
+/**
+ * Get Feature Status Tool
+ * Version: 0.1.0
+ */
+import { buildDevelopmentEvalContext } from '../domain/development-evals.js';
+import { getNextPhaseId, getPhaseContract } from '../domain/phases.js';
+import { formatOpenGateSummary } from '../domain/quality-gates.js';
+import { createErrorResult, createTextResult } from '../utils.js';
+export async function handleGetFeatureStatus(adapter, input) {
+    const feature = await adapter.getFeature(input.feature_id);
+    if (feature == null) {
+        return createErrorResult(`Feature ${input.feature_id} was not found.`, {
+            feature_id: input.feature_id,
+        });
+    }
+    const [artifacts, review_checks, learnings, open_blockers, open_gate_records, open_findings, pending_claims, claim_verification, latest_feature_eval,] = await Promise.all([
+        adapter.listPhaseArtifacts(input.feature_id),
+        adapter.listReviewChecks(input.feature_id),
+        adapter.listLearnings(input.feature_id),
+        adapter.listOpenBlockers(input.feature_id),
+        adapter.listOpenGateRecords(input.feature_id),
+        adapter.listOpenFindings(input.feature_id),
+        adapter.listPendingClaims(input.feature_id),
+        adapter.listClaimVerificationStatus(input.feature_id),
+        adapter.getLatestFeatureEval(input.feature_id),
+    ]);
+    const current_phase = getPhaseContract(feature.current_phase);
+    const next_phase_id = getNextPhaseId(feature.current_phase);
+    const next_phase = next_phase_id == null ? null : getPhaseContract(next_phase_id);
+    const latest_review_check = review_checks.at(-1) ?? null;
+    const open_gates = open_gate_records.map(formatOpenGateSummary);
+    const development_evals = buildDevelopmentEvalContext(feature, feature.current_phase, artifacts, open_gate_records);
+    return createTextResult(`Feature ${feature.id} is ${feature.status} in ${current_phase.name}.`, {
+        feature,
+        current_phase,
+        next_phase,
+        counts: {
+            artifacts: artifacts.length,
+            review_checks: review_checks.length,
+            learnings: learnings.length,
+            open_blockers: open_blockers.length,
+            open_gates: open_gates.length,
+            open_findings: open_findings.length,
+            pending_claims: pending_claims.length,
+        },
+        workflow: {
+            open_blockers,
+            open_gates,
+            open_gate_records,
+            open_findings,
+            pending_claims,
+            claim_verification_summary: {
+                total: claim_verification.length,
+                passed: claim_verification.filter((claim) => claim.final_status === 'PASS').length,
+                failed: claim_verification.filter((claim) => claim.final_status === 'FAIL').length,
+                needs_review: claim_verification.filter((claim) => claim.final_status === 'NEEDS_REVIEW').length,
+                pending: claim_verification.filter((claim) => claim.final_status === 'PENDING').length,
+            },
+        },
+        development_evals,
+        latest_feature_eval,
+        latest_review_check,
+        claim_verification,
+        recent_artifacts: artifacts.slice(-5),
+        recent_learnings: learnings.slice(0, 5),
+    });
+}
+//# sourceMappingURL=get-feature-status.js.map

package/dist/tools/get-feature-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-feature-status.js","sourceRoot":"","sources":["../../src/tools/get-feature-status.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAElE,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAA6B,EAC7B,KAA4B;IAE5B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC3D,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QACpB,OAAO,iBAAiB,CAAC,WAAW,KAAK,CAAC,UAAU,iBAAiB,EAAE;YACrE,UAAU,EAAE,KAAK,CAAC,UAAU;SAC7B,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CACJ,SAAS,EACT,aAAa,EACb,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACpB,GACC,MAAM,OAAO,CAAC,GAAG,CAAC;QAChB,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,UAAU,CAAC;QAC5C,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC;QAC1C,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC;QACvC,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC;QAC1C,OAAO,CAAC,mBAAmB,CAAC,KAAK,CAAC,UAAU,CAAC;QAC7C,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC;QAC1C,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,UAAU,CAAC;QAC3C,OAAO,CAAC,2BAA2B,CAAC,KAAK,CAAC,UAAU,CAAC;QACrD,OAAO,CAAC,oBAAoB,CAAC,KAAK,CAAC,UAAU,CAAC;KAC/C,CAAC,CAAC;IAEL,MAAM,aAAa,GAAG,gBAAgB,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC9D,MAAM,aAAa,GAAG,cAAc,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAG,aAAa,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAClF,MAAM,mBAAmB,GAAG,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IACzD,MAAM,UAAU,GAAG,iBAAiB,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IAChE,MAAM,iBAAiB,GAAG,2BAA2B,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,EAAE,SAAS,EAAE,iBAAiB,CAAC,CAAC;IAEpH,OAAO,gBAAgB,CACrB,WAAW,OAAO,CAAC,EAAE,OAAO,OAAO,CAAC,MAAM,OAAO,aAAa,CAAC,IAAI,GAAG,EACtE;QACE,OAAO;QACP,aAAa;QACb,UAAU;QACV,MAAM,EAAE;YACN,SAAS,EAAE,SAAS,CAAC,MAAM;YAC3B,aAAa,EAAE,aAAa,CAAC,MAAM;YACnC,SAAS,EAAE,SAAS,CAAC,MAAM;YAC3B,aAAa,EAAE,aAAa,CAAC,MAAM;YACnC,UAAU,EAAE,UAAU,CAAC,MAAM;YAC7B,aAAa,EAAE,aAAa,CAAC,MAAM;YACnC,cAAc,EAAE,cAAc,CAAC,MAAM;SACtC;QACD,QAAQ,EAAE;YACR,aAAa;YACb,UAAU;YACV,iBAAiB;YACjB,aAAa;YACb,cAAc;YACd,0BAA0B,EAAE;gBAC1B,KAAK,EAAE,kBAAkB,CAAC,MAAM;gBAChC,MAAM,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,YAAY,KAAK,MAAM,CAAC,CAAC,MAAM;gBAClF,MAAM,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,YAAY,KAAK,MAAM,CAAC,CAAC,MAAM;gBAClF,YAAY,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,YAAY,KAAK,cAAc,CAAC,CAAC,MAAM;gBAChG,OAAO,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,MAAM;aACvF;SACF;QACD,iBAAiB;QACjB,mBAAmB;QACnB,mBAAmB;QACnB,kBAAkB;QAClB,gBAAgB,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACrC,gBAAgB,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;KACxC,CACF,CAAC;AACJ,CAAC"}