open-wiki-spec 0.1.0

package/dist/core/workflow/propose/note-creator.js

@@ -0,0 +1,178 @@
+import { join } from 'node:path';
+import { stringify } from 'yaml';
+import { generateId } from '../../../utils/id-generator.js';
+/**
+ * Create a Feature note with stub sections.
+ */
+export function createFeatureNote(vaultRoot, query, index, deps) {
+    const featureId = generateId('feature', query.summary);
+    const title = titleFromId(featureId, 'feature');
+    // Resolve systems from query's system_terms
+    const systems = [];
+    for (const term of query.system_terms) {
+        const systemRecord = findSystemByName(term, index);
+        if (systemRecord) {
+            systems.push(`[[${systemRecord.title}]]`);
+        }
+    }
+    const frontmatter = {
+        type: 'feature',
+        id: featureId,
+        status: 'active',
+        systems,
+        sources: [],
+        decisions: [],
+        changes: [],
+        tags: ['feature'],
+    };
+    const body = [
+        `# Feature: ${title}`,
+        '',
+        '## Purpose',
+        '',
+        '## Current Behavior',
+        '',
+        '## Constraints',
+        '',
+        '## Known Gaps',
+        '',
+        '## Requirements',
+        '',
+        '## Related Notes',
+        '',
+    ].join('\n');
+    const content = formatNoteContent(frontmatter, body);
+    const featurePath = join(vaultRoot, 'wiki', '03-features', `${slugFromId(featureId)}.md`);
+    deps.writeFile(featurePath, content);
+    return { id: featureId, path: featurePath };
+}
+/**
+ * Create a Change note linked to a Feature with stub sections.
+ */
+export function createChangeNote(vaultRoot, feature, query, sequencingFull, index, deps) {
+    const changeId = generateId('change', query.summary);
+    const title = titleFromId(changeId, 'change');
+    const depends_on = computeDependsOn(feature, sequencingFull);
+    const touches = computeTouches(feature, query, index);
+    const featureTitle = feature.title ?? feature.id;
+    const frontmatter = {
+        type: 'change',
+        id: changeId,
+        status: 'proposed',
+        created_at: new Date().toISOString().slice(0, 10),
+        feature: `[[${featureTitle}]]`,
+        depends_on: depends_on.map((id) => {
+            const rec = index.records.get(id);
+            return `[[${rec?.title ?? id}]]`;
+        }),
+        touches: touches.map((id) => {
+            const rec = index.records.get(id);
+            return `[[${rec?.title ?? id}]]`;
+        }),
+        systems: [],
+        sources: [],
+        decisions: [],
+        tags: ['change'],
+    };
+    const body = [
+        `# Change: ${title}`,
+        '',
+        '## Why',
+        '',
+        '## Delta Summary',
+        '',
+        '## Proposed Update',
+        '',
+        '## Design Approach',
+        '',
+        '## Impact',
+        '',
+        '## Tasks',
+        '',
+        '## Validation',
+        '',
+        '## Status Notes',
+        '',
+    ].join('\n');
+    const content = formatNoteContent(frontmatter, body);
+    const changePath = join(vaultRoot, 'wiki', '04-changes', `${slugFromId(changeId)}.md`);
+    deps.writeFile(changePath, content);
+    return { id: changeId, path: changePath };
+}
+/**
+ * Compute depends_on from sequencing analysis.
+ * Depends on the earlier change in any pairwise severity or requirement conflict
+ * that touches the same Feature.
+ */
+export function computeDependsOn(feature, sequencingFull) {
+    const depends_on = [];
+    for (const overlap of sequencingFull.pairwise_severities) {
+        if (overlap.overlapping_features.includes(feature.id)) {
+            const posA = sequencingFull.ordering.find((o) => o.id === overlap.change_a)?.position ?? Infinity;
+            const posB = sequencingFull.ordering.find((o) => o.id === overlap.change_b)?.position ?? Infinity;
+            const earlierId = posA < posB ? overlap.change_a : overlap.change_b;
+            if (!depends_on.includes(earlierId)) {
+                depends_on.push(earlierId);
+            }
+        }
+    }
+    for (const conflict of sequencingFull.requirement_conflicts) {
+        if (conflict.feature_id === feature.id) {
+            const posA = sequencingFull.ordering.find((o) => o.id === conflict.change_a)?.position ?? Infinity;
+            const posB = sequencingFull.ordering.find((o) => o.id === conflict.change_b)?.position ?? Infinity;
+            const earlierId = posA < posB ? conflict.change_a : conflict.change_b;
+            if (!depends_on.includes(earlierId)) {
+                depends_on.push(earlierId);
+            }
+        }
+    }
+    return [...new Set(depends_on)];
+}
+/**
+ * Compute touches from target Feature + query system_terms + Feature's systems.
+ */
+export function computeTouches(feature, query, index) {
+    const touches = [feature.id];
+    for (const term of query.system_terms) {
+        const systemRecord = findSystemByName(term, index);
+        if (systemRecord) {
+            touches.push(systemRecord.id);
+        }
+    }
+    const featureRecord = index.records.get(feature.id);
+    if (featureRecord) {
+        for (const sysId of featureRecord.systems) {
+            if (!touches.includes(sysId)) {
+                touches.push(sysId);
+            }
+        }
+    }
+    return [...new Set(touches)];
+}
+function findSystemByName(term, index) {
+    const lowerTerm = term.toLowerCase();
+    for (const record of index.records.values()) {
+        if (record.type !== 'system')
+            continue;
+        if (record.title.toLowerCase() === lowerTerm)
+            return record;
+        if (record.aliases.some((a) => a.toLowerCase() === lowerTerm))
+            return record;
+    }
+    return null;
+}
+function titleFromId(id, prefix) {
+    const slug = id.startsWith(`${prefix}-`) ? id.slice(prefix.length + 1) : id;
+    return slug
+        .split('-')
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(' ');
+}
+function slugFromId(id) {
+    return id;
+}
+function formatNoteContent(frontmatter, body) {
+    const yamlStr = stringify(frontmatter, { lineWidth: 0 });
+    return `---\n${yamlStr}---\n\n${body}`;
+}
+//# sourceMappingURL=note-creator.js.map

package/dist/core/workflow/propose/note-creator.js.map

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

package/dist/core/workflow/propose/prerequisites.d.ts

@@ -0,0 +1,17 @@
+import type { ParseResult } from '../../parser/types.js';
+import type { PlannedPrerequisites } from './types.js';
+/**
+ * Check hard and soft prerequisites for the proposed -> planned transition.
+ *
+ * Hard prerequisites (ALL required):
+ *   1. Why section exists and is non-empty
+ *   2. Delta Summary has >= 1 entry
+ *   3. Tasks has >= 1 item
+ *   4. Validation section exists and is non-empty
+ *
+ * Soft prerequisites (warning only):
+ *   5. Design Approach exists
+ *   6. Decision link exists in frontmatter
+ */
+export declare function checkPlannedPrerequisites(parsed: ParseResult): PlannedPrerequisites;
+//# sourceMappingURL=prerequisites.d.ts.map

package/dist/core/workflow/propose/prerequisites.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prerequisites.d.ts","sourceRoot":"","sources":["../../../../src/core/workflow/propose/prerequisites.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGvD;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,WAAW,GAAG,oBAAoB,CAqCnF"}

package/dist/core/workflow/propose/prerequisites.js

@@ -0,0 +1,78 @@
+/**
+ * Check hard and soft prerequisites for the proposed -> planned transition.
+ *
+ * Hard prerequisites (ALL required):
+ *   1. Why section exists and is non-empty
+ *   2. Delta Summary has >= 1 entry
+ *   3. Tasks has >= 1 item
+ *   4. Validation section exists and is non-empty
+ *
+ * Soft prerequisites (warning only):
+ *   5. Design Approach exists
+ *   6. Decision link exists in frontmatter
+ */
+export function checkPlannedPrerequisites(parsed) {
+    const why_present = sectionHasContent(parsed, 'Why');
+    const delta_summary_present = parsed.deltaSummary.length > 0;
+    const tasks_present = parsed.tasks.length > 0;
+    const validation_present = sectionHasContent(parsed, 'Validation');
+    const all_hard_met = why_present && delta_summary_present && tasks_present && validation_present;
+    // Soft prerequisites: Design Approach must have content or contain 'N/A'
+    const design_approach_present = sectionHasContent(parsed, 'Design Approach') ||
+        sectionContainsText(parsed, 'Design Approach', 'N/A');
+    const fm = parsed.frontmatter;
+    const decision_link_present = (fm?.decisions?.length ?? 0) > 0;
+    const warnings = [];
+    if (!design_approach_present) {
+        warnings.push('Design Approach section is empty (soft prerequisite)');
+    }
+    if (!decision_link_present) {
+        warnings.push('No Decision links found (soft prerequisite for complex changes)');
+    }
+    return {
+        hard: {
+            why_present,
+            delta_summary_present,
+            tasks_present,
+            validation_present,
+        },
+        soft: {
+            design_approach_present,
+            decision_link_present,
+        },
+        all_hard_met,
+        warnings,
+    };
+}
+/**
+ * Check if a section exists and has non-empty content.
+ */
+function sectionHasContent(parsed, sectionTitle) {
+    const section = findSection(parsed.sections, sectionTitle);
+    if (!section)
+        return false;
+    return section.content.trim().length > 0;
+}
+/**
+ * Check if a section contains specific text.
+ */
+function sectionContainsText(parsed, sectionTitle, text) {
+    const section = findSection(parsed.sections, sectionTitle);
+    if (!section)
+        return false;
+    return section.content.includes(text);
+}
+/**
+ * Find a section by title in the section tree (depth-first search).
+ */
+function findSection(sections, title) {
+    for (const section of sections) {
+        if (section.title.trim() === title)
+            return section;
+        const found = findSection(section.children, title);
+        if (found)
+            return found;
+    }
+    return null;
+}
+//# sourceMappingURL=prerequisites.js.map

package/dist/core/workflow/propose/prerequisites.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prerequisites.js","sourceRoot":"","sources":["../../../../src/core/workflow/propose/prerequisites.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAmB;IAC3D,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACrD,MAAM,qBAAqB,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;IAC7D,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9C,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAEnE,MAAM,YAAY,GAAG,WAAW,IAAI,qBAAqB,IAAI,aAAa,IAAI,kBAAkB,CAAC;IAEjG,yEAAyE;IACzE,MAAM,uBAAuB,GAAG,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,CAAC;QAC1E,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,EAAE,KAAK,CAAC,CAAC;IAExD,MAAM,EAAE,GAAG,MAAM,CAAC,WAAuC,CAAC;IAC1D,MAAM,qBAAqB,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAE/D,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAC7B,QAAQ,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC3B,QAAQ,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;IACnF,CAAC;IAED,OAAO;QACL,IAAI,EAAE;YACJ,WAAW;YACX,qBAAqB;YACrB,aAAa;YACb,kBAAkB;SACnB;QACD,IAAI,EAAE;YACJ,uBAAuB;YACvB,qBAAqB;SACtB;QACD,YAAY;QACZ,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,MAAmB,EAAE,YAAoB;IAClE,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAC3D,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,MAAmB,EAAE,YAAoB,EAAE,IAAY;IAClF,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAC3D,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,OAAO,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,QAAiC,EAAE,KAAa;IACnE,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,KAAK;YAAE,OAAO,OAAO,CAAC;QACnD,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACnD,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC1B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/core/workflow/propose/propose.d.ts

@@ -0,0 +1,13 @@
+import type { ProposeDeps, ProposeOptions, ProposeResult } from './types.js';
+/**
+ * Main propose workflow.
+ *
+ * 1. Build index
+ * 2. Normalize query
+ * 3. Run preflight (sequencing + retrieval with classification)
+ * 4. Route based on classification
+ * 5. Check prerequisites
+ * 6. Transition to planned if ready
+ */
+export declare function propose(userRequest: string, options: ProposeOptions, deps: ProposeDeps): Promise<ProposeResult>;
+//# sourceMappingURL=propose.d.ts.map

package/dist/core/workflow/propose/propose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"propose.d.ts","sourceRoot":"","sources":["../../../../src/core/workflow/propose/propose.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,aAAa,EAId,MAAM,YAAY,CAAC;AAuFpB;;;;;;;;;GASG;AACH,wBAAsB,OAAO,CAC3B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,aAAa,CAAC,CA6CxB"}

package/dist/core/workflow/propose/propose.js

@@ -0,0 +1,204 @@
+import { normalizeQuery } from './query-normalizer.js';
+import { checkPlannedPrerequisites } from './prerequisites.js';
+import { createFeatureNote, createChangeNote } from './note-creator.js';
+/**
+ * Map local intent aliases to RetrievalQuery intent.
+ */
+function mapIntent(intent) {
+    switch (intent) {
+        case 'fix': return 'modify';
+        case 'investigate': return 'query';
+        default: return intent;
+    }
+}
+/**
+ * Run preflight: sequencing analysis + retrieval with classification.
+ * Classification is done inside retrieve() by plan 05. Plan 07 does NOT re-classify.
+ */
+function runPreflight(query, index, deps) {
+    const sequencingFull = deps.analyzeSequencing(index.records);
+    const retrieval = deps.retrieve(index, {
+        intent: mapIntent(query.intent),
+        summary: query.summary,
+        feature_terms: query.feature_terms,
+        system_terms: query.system_terms,
+        entity_terms: query.entity_terms,
+        status_bias: query.status_bias,
+    }, { sequencing: sequencingFull });
+    return { retrieval, sequencingFull };
+}
+/**
+ * Wrap RetrievalResult into a ClassificationResult envelope.
+ */
+function buildClassificationResult(retrieval) {
+    return {
+        classification: retrieval.classification,
+        confidence: retrieval.confidence,
+        primary_candidate: retrieval.candidates[0] ?? null,
+        secondary_candidate: retrieval.candidates[1] ?? null,
+        reasons: retrieval.candidates[0]?.reasons ?? [],
+    };
+}
+/**
+ * Resolve the Feature linked to a Change record.
+ */
+function resolveFeatureFromChange(change, index) {
+    const featureId = change.feature ?? change.features?.[0];
+    if (!featureId)
+        return null;
+    return index.records.get(featureId) ?? null;
+}
+/**
+ * Extract sequencing warnings from reasons.
+ * Include reasons that indicate actual problems: touch overlaps, conflicts, stale bases,
+ * cycles, out-of-order errors, blocked dependencies, and needs_review.
+ */
+function extractSequencingWarnings(sequencingFull) {
+    return sequencingFull.reasons.filter((r) => r.includes('needs_review') ||
+        r.includes('conflict') ||
+        r.includes('stale') ||
+        r.includes('out-of-order') ||
+        r.includes('cycle') ||
+        r.includes('blocked') ||
+        r.includes('both touch') ||
+        r.includes('both changes operate') ||
+        r.includes('jumped ahead'));
+}
+/**
+ * Main propose workflow.
+ *
+ * 1. Build index
+ * 2. Normalize query
+ * 3. Run preflight (sequencing + retrieval with classification)
+ * 4. Route based on classification
+ * 5. Check prerequisites
+ * 6. Transition to planned if ready
+ */
+export async function propose(userRequest, options, deps) {
+    // 0. Build index
+    const index = await deps.buildIndex(options.vaultRoot);
+    // 1. Normalize query
+    const query = normalizeQuery(userRequest);
+    // 2. Run preflight
+    const { retrieval, sequencingFull } = runPreflight(query, index, deps);
+    // 3. Allow force override
+    let effectiveRetrieval = retrieval;
+    if (options.forceClassification) {
+        effectiveRetrieval = { ...retrieval, classification: options.forceClassification };
+    }
+    // 4. Build classification result
+    const classification = buildClassificationResult(effectiveRetrieval);
+    const sequencing_warnings = extractSequencingWarnings(sequencingFull);
+    // 5. Dry run
+    if (options.dryRun) {
+        return {
+            action: classificationToAction(classification.classification),
+            retrieval: effectiveRetrieval,
+            classification,
+            target_change: null,
+            target_feature: null,
+            prerequisites: null,
+            transitioned_to_planned: false,
+            sequencing_warnings,
+        };
+    }
+    // 6. Execute post-classification action
+    return executePostClassification(classification, query, sequencingFull, effectiveRetrieval, index, options.vaultRoot, sequencing_warnings, deps);
+}
+function classificationToAction(classification) {
+    switch (classification) {
+        case 'existing_change': return 'continued_change';
+        case 'existing_feature': return 'created_change';
+        case 'new_feature': return 'created_feature_and_change';
+        case 'needs_confirmation': return 'asked_user';
+        default: return 'asked_user';
+    }
+}
+function executePostClassification(classification, query, sequencingFull, retrieval, index, vaultRoot, sequencing_warnings, deps) {
+    switch (classification.classification) {
+        case 'existing_change': {
+            const candidate = classification.primary_candidate;
+            if (!candidate) {
+                return makeAskedUserResult(retrieval, classification, sequencing_warnings);
+            }
+            const change = index.records.get(candidate.id);
+            if (!change) {
+                return makeAskedUserResult(retrieval, classification, sequencing_warnings);
+            }
+            const feature = resolveFeatureFromChange(change, index);
+            return {
+                action: 'continued_change',
+                retrieval,
+                classification,
+                target_change: { id: change.id, path: change.path, status: change.status },
+                target_feature: feature ? { id: feature.id, path: feature.path } : null,
+                prerequisites: null,
+                transitioned_to_planned: false,
+                sequencing_warnings,
+            };
+        }
+        case 'existing_feature': {
+            const candidate = classification.primary_candidate;
+            if (!candidate) {
+                return makeAskedUserResult(retrieval, classification, sequencing_warnings);
+            }
+            const feature = index.records.get(candidate.id);
+            if (!feature) {
+                return makeAskedUserResult(retrieval, classification, sequencing_warnings);
+            }
+            const { id: changeId, path: changePath } = createChangeNote(vaultRoot, { id: feature.id, title: feature.title }, query, sequencingFull, index, deps);
+            const parsed = deps.parseNote(changePath);
+            const prerequisites = checkPlannedPrerequisites(parsed);
+            return {
+                action: 'created_change',
+                retrieval,
+                classification,
+                target_change: {
+                    id: changeId,
+                    path: changePath,
+                    status: prerequisites.all_hard_met ? 'planned' : 'proposed',
+                },
+                target_feature: { id: feature.id, path: feature.path },
+                prerequisites,
+                transitioned_to_planned: prerequisites.all_hard_met,
+                sequencing_warnings,
+            };
+        }
+        case 'new_feature': {
+            const { id: featureId, path: featurePath } = createFeatureNote(vaultRoot, query, index, deps);
+            const { id: changeId, path: changePath } = createChangeNote(vaultRoot, { id: featureId }, query, sequencingFull, index, deps);
+            const parsed = deps.parseNote(changePath);
+            const prerequisites = checkPlannedPrerequisites(parsed);
+            return {
+                action: 'created_feature_and_change',
+                retrieval,
+                classification,
+                target_change: {
+                    id: changeId,
+                    path: changePath,
+                    status: prerequisites.all_hard_met ? 'planned' : 'proposed',
+                },
+                target_feature: { id: featureId, path: featurePath },
+                prerequisites,
+                transitioned_to_planned: prerequisites.all_hard_met,
+                sequencing_warnings,
+            };
+        }
+        case 'needs_confirmation':
+        default:
+            return makeAskedUserResult(retrieval, classification, sequencing_warnings);
+    }
+}
+function makeAskedUserResult(retrieval, classification, sequencing_warnings) {
+    return {
+        action: 'asked_user',
+        retrieval,
+        classification,
+        target_change: null,
+        target_feature: null,
+        prerequisites: null,
+        transitioned_to_planned: false,
+        sequencing_warnings,
+    };
+}
+//# sourceMappingURL=propose.js.map

package/dist/core/workflow/propose/propose.js.map

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

package/dist/core/workflow/propose/query-normalizer.d.ts

@@ -0,0 +1,7 @@
+import type { QueryObject } from './types.js';
+/**
+ * Normalize a natural language user request into a structured QueryObject.
+ * Intent detection + term extraction.
+ */
+export declare function normalizeQuery(userRequest: string): QueryObject;
+//# sourceMappingURL=query-normalizer.d.ts.map

package/dist/core/workflow/propose/query-normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-normalizer.d.ts","sourceRoot":"","sources":["../../../../src/core/workflow/propose/query-normalizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,YAAY,CAAC;AA6B3D;;;GAGG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAsC/D"}

package/dist/core/workflow/propose/query-normalizer.js

@@ -0,0 +1,77 @@
+const STOP_WORDS = new Set([
+    'a', 'an', 'the', 'is', 'are', 'was', 'were', 'be', 'been', 'being',
+    'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'shall',
+    'should', 'may', 'might', 'must', 'can', 'could', 'to', 'of', 'in',
+    'for', 'on', 'with', 'at', 'by', 'from', 'as', 'into', 'through',
+    'during', 'before', 'after', 'above', 'below', 'between', 'and', 'but',
+    'or', 'nor', 'not', 'so', 'yet', 'both', 'either', 'neither', 'each',
+    'every', 'all', 'any', 'few', 'more', 'most', 'other', 'some', 'such',
+    'no', 'only', 'own', 'same', 'than', 'too', 'very', 'just', 'it',
+    'its', 'this', 'that', 'these', 'those', 'i', 'we', 'you', 'he',
+    'she', 'they', 'me', 'us', 'him', 'her', 'them', 'my', 'our',
+    'your', 'his', 'their', 'what', 'which', 'who', 'whom', 'when',
+    'where', 'why', 'how', 'new',
+]);
+const INTENT_KEYWORDS = [
+    { pattern: /\b(fix|bug|broken|error|crash)\b/i, intent: 'fix' },
+    { pattern: /\b(change|update|modify|refactor|improve)\b/i, intent: 'modify' },
+    { pattern: /\b(remove|delete|deprecate|drop)\b/i, intent: 'remove' },
+    { pattern: /\b(investigate|research|explore|analyze|query)\b/i, intent: 'investigate' },
+];
+// Matches camelCase or snake_case tokens
+const ENTITY_PATTERN = /^(?:[a-z]+[A-Z][a-zA-Z]*|[a-z]+_[a-z_]+)$/;
+const MAX_SUMMARY_LENGTH = 500;
+/**
+ * Normalize a natural language user request into a structured QueryObject.
+ * Intent detection + term extraction.
+ */
+export function normalizeQuery(userRequest) {
+    const trimmed = userRequest.trim();
+    if (!trimmed) {
+        throw new Error('User request cannot be empty');
+    }
+    const summary = trimmed.length > MAX_SUMMARY_LENGTH
+        ? trimmed.slice(0, MAX_SUMMARY_LENGTH)
+        : trimmed;
+    const intent = detectIntent(trimmed);
+    const words = extractWords(trimmed);
+    const significantWords = words.filter((w) => !STOP_WORDS.has(w.toLowerCase()) && w.length > 1);
+    const entity_terms = [];
+    const feature_terms = [];
+    for (const word of significantWords) {
+        // Skip intent keywords from feature_terms
+        if (isIntentKeyword(word))
+            continue;
+        if (ENTITY_PATTERN.test(word)) {
+            entity_terms.push(word);
+        }
+        else {
+            feature_terms.push(word.toLowerCase());
+        }
+    }
+    return {
+        intent,
+        summary,
+        feature_terms: [...new Set(feature_terms)],
+        system_terms: [], // populated later when index is available
+        entity_terms: [...new Set(entity_terms)],
+        status_bias: ['active', 'proposed', 'planned', 'in_progress'],
+    };
+}
+function detectIntent(text) {
+    for (const { pattern, intent } of INTENT_KEYWORDS) {
+        if (pattern.test(text)) {
+            return intent;
+        }
+    }
+    return 'add';
+}
+function extractWords(text) {
+    // Split on whitespace/punctuation but keep camelCase and snake_case intact
+    return text.split(/[\s,;:!?()\[\]{}]+/).filter(Boolean);
+}
+function isIntentKeyword(word) {
+    const lower = word.toLowerCase();
+    return INTENT_KEYWORDS.some(({ pattern }) => pattern.test(lower));
+}
+//# sourceMappingURL=query-normalizer.js.map

package/dist/core/workflow/propose/query-normalizer.js.map

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