@mobiman/vector 1.1.0

package/core/bin/lib/state.d.cts

@@ -0,0 +1,47 @@
+/**
+ * State — STATE.md operations and progression engine
+ */
+export declare function stateExtractField(content: string, fieldName: string): string | null;
+export declare function cmdStateLoad(cwd: string, raw: boolean): void;
+export declare function cmdStateGet(cwd: string, section: string | undefined, raw: boolean): void;
+export declare function cmdStatePatch(cwd: string, patches: Record<string, string>, raw: boolean): void;
+export declare function cmdStateUpdate(cwd: string, field: string | undefined, value: string | undefined): void;
+export declare function stateReplaceField(content: string, fieldName: string, newValue: string): string | null;
+export declare function cmdStateAdvancePlan(cwd: string, raw: boolean): void;
+interface RecordMetricOptions {
+    phase: string | null;
+    plan: string | null;
+    duration: string | null;
+    tasks?: string | null;
+    files?: string | null;
+}
+export declare function cmdStateRecordMetric(cwd: string, options: RecordMetricOptions, raw: boolean): void;
+export declare function cmdStateUpdateProgress(cwd: string, raw: boolean): void;
+interface AddDecisionOptions {
+    phase?: string | null;
+    summary?: string | null;
+    summary_file?: string | null;
+    rationale?: string | null;
+    rationale_file?: string | null;
+}
+export declare function cmdStateAddDecision(cwd: string, options: AddDecisionOptions, raw: boolean): void;
+interface AddBlockerOptions {
+    text?: string | null;
+    text_file?: string | null;
+}
+export declare function cmdStateAddBlocker(cwd: string, text: string | AddBlockerOptions, raw: boolean): void;
+export declare function cmdStateResolveBlocker(cwd: string, text: string | null | undefined, raw: boolean): void;
+interface RecordSessionOptions {
+    stopped_at?: string | null;
+    resume_file?: string | null;
+}
+export declare function cmdStateRecordSession(cwd: string, options: RecordSessionOptions, raw: boolean): void;
+export declare function cmdStateSnapshot(cwd: string, raw: boolean): void;
+/**
+ * Write STATE.md with synchronized YAML frontmatter.
+ * All STATE.md writes should use this instead of raw writeFileSync.
+ */
+export declare function writeStateMd(statePath: string, content: string, cwd: string): void;
+export declare function cmdStateJson(cwd: string, raw: boolean): void;
+export {};
+//# sourceMappingURL=state.d.cts.map

package/core/bin/lib/state.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.cts","sourceRoot":"","sources":["state.cts"],"names":[],"mappings":"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"}

package/core/bin/lib/template.cjs

@@ -0,0 +1,220 @@
+"use strict";
+/**
+ * Template — Template selection and fill operations
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmdTemplateSelect = cmdTemplateSelect;
+exports.cmdTemplateFill = cmdTemplateFill;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const core_cjs_1 = require("./core.cjs");
+const frontmatter_cjs_1 = require("./frontmatter.cjs");
+function cmdTemplateSelect(cwd, planPath, raw) {
+    if (!planPath) {
+        (0, core_cjs_1.error)('plan-path required');
+    }
+    try {
+        const fullPath = path_1.default.join(cwd, planPath);
+        const content = fs_1.default.readFileSync(fullPath, 'utf-8');
+        // Simple heuristics
+        const taskMatch = content.match(/###\s*Task\s*\d+/g) || [];
+        const taskCount = taskMatch.length;
+        const decisionMatch = content.match(/decision/gi) || [];
+        const hasDecisions = decisionMatch.length > 0;
+        // Count file mentions
+        const fileMentions = new Set();
+        const filePattern = /`([^`]+\.[a-zA-Z]+)`/g;
+        let m;
+        while ((m = filePattern.exec(content)) !== null) {
+            if (m[1].includes('/') && !m[1].startsWith('http')) {
+                fileMentions.add(m[1]);
+            }
+        }
+        const fileCount = fileMentions.size;
+        let template = 'templates/summary-standard.md';
+        let type = 'standard';
+        if (taskCount <= 2 && fileCount <= 3 && !hasDecisions) {
+            template = 'templates/summary-minimal.md';
+            type = 'minimal';
+        }
+        else if (hasDecisions || fileCount > 6 || taskCount > 5) {
+            template = 'templates/summary-complex.md';
+            type = 'complex';
+        }
+        const result = { template, type, taskCount, fileCount, hasDecisions };
+        (0, core_cjs_1.output)(result, raw, template);
+    }
+    catch (e) {
+        // Fallback to standard
+        (0, core_cjs_1.output)({ template: 'templates/summary-standard.md', type: 'standard', error: e.message }, raw, 'templates/summary-standard.md');
+    }
+}
+function cmdTemplateFill(cwd, templateType, options, raw) {
+    if (!templateType) {
+        (0, core_cjs_1.error)('template type required: summary, plan, or verification');
+    }
+    if (!options.phase) {
+        (0, core_cjs_1.error)('--phase required');
+    }
+    const phaseInfo = (0, core_cjs_1.findPhaseInternal)(cwd, options.phase);
+    if (!phaseInfo || !phaseInfo.found) {
+        (0, core_cjs_1.output)({ error: 'Phase not found', phase: options.phase }, raw);
+        return;
+    }
+    const padded = (0, core_cjs_1.normalizePhaseName)(options.phase);
+    const today = new Date().toISOString().split('T')[0];
+    const phaseName = options.name || phaseInfo.phase_name || 'Unnamed';
+    const phaseSlug = phaseInfo.phase_slug || (0, core_cjs_1.generateSlugInternal)(phaseName);
+    const phaseId = `${padded}-${phaseSlug}`;
+    const planNum = (options.plan || '01').padStart(2, '0');
+    const fields = options.fields || {};
+    let frontmatter, body, fileName;
+    switch (templateType) {
+        case 'summary': {
+            frontmatter = {
+                phase: phaseId,
+                plan: planNum,
+                subsystem: '[primary category]',
+                tags: [],
+                provides: [],
+                affects: [],
+                'tech-stack': { added: [], patterns: [] },
+                'key-files': { created: [], modified: [] },
+                'key-decisions': [],
+                'patterns-established': [],
+                duration: '[X]min',
+                completed: today,
+                ...fields,
+            };
+            body = [
+                `# Phase ${options.phase}: ${phaseName} Summary`,
+                '',
+                '**[Substantive one-liner describing outcome]**',
+                '',
+                '## Performance',
+                '- **Duration:** [time]',
+                '- **Tasks:** [count completed]',
+                '- **Files modified:** [count]',
+                '',
+                '## Accomplishments',
+                '- [Key outcome 1]',
+                '- [Key outcome 2]',
+                '',
+                '## Task Commits',
+                '1. **Task 1: [task name]** - `hash`',
+                '',
+                '## Files Created/Modified',
+                '- `path/to/file.ts` - What it does',
+                '',
+                '## Decisions & Deviations',
+                '[Key decisions or "None - followed plan as specified"]',
+                '',
+                '## Next Phase Readiness',
+                '[What\'s ready for next phase]',
+            ].join('\n');
+            fileName = `${padded}-${planNum}-SUMMARY.md`;
+            break;
+        }
+        case 'plan': {
+            const planType = options.type || 'execute';
+            const wave = parseInt(options.wave || '1') || 1;
+            frontmatter = {
+                phase: phaseId,
+                plan: planNum,
+                type: planType,
+                wave,
+                depends_on: [],
+                files_modified: [],
+                autonomous: true,
+                user_setup: [],
+                must_haves: { truths: [], artifacts: [], key_links: [] },
+                ...fields,
+            };
+            body = [
+                `# Phase ${options.phase} Plan ${planNum}: [Title]`,
+                '',
+                '## Objective',
+                '- **What:** [What this plan builds]',
+                '- **Why:** [Why it matters for the phase goal]',
+                '- **Output:** [Concrete deliverable]',
+                '',
+                '## Context',
+                '@.planning/PROJECT.md',
+                '@.planning/ROADMAP.md',
+                '@.planning/STATE.md',
+                '',
+                '## Tasks',
+                '',
+                '<task type="code">',
+                '  <name>[Task name]</name>',
+                '  <files>[file paths]</files>',
+                '  <action>[What to do]</action>',
+                '  <verify>[How to verify]</verify>',
+                '  <done>[Definition of done]</done>',
+                '</task>',
+                '',
+                '## Verification',
+                '[How to verify this plan achieved its objective]',
+                '',
+                '## Success Criteria',
+                '- [ ] [Criterion 1]',
+                '- [ ] [Criterion 2]',
+            ].join('\n');
+            fileName = `${padded}-${planNum}-PLAN.md`;
+            break;
+        }
+        case 'verification': {
+            frontmatter = {
+                phase: phaseId,
+                verified: new Date().toISOString(),
+                status: 'pending',
+                score: '0/0 must-haves verified',
+                ...fields,
+            };
+            body = [
+                `# Phase ${options.phase}: ${phaseName} — Verification`,
+                '',
+                '## Observable Truths',
+                '| # | Truth | Status | Evidence |',
+                '|---|-------|--------|----------|',
+                '| 1 | [Truth] | pending | |',
+                '',
+                '## Required Artifacts',
+                '| Artifact | Expected | Status | Details |',
+                '|----------|----------|--------|---------|',
+                '| [path] | [what] | pending | |',
+                '',
+                '## Key Link Verification',
+                '| From | To | Via | Status | Details |',
+                '|------|----|----|--------|---------|',
+                '| [source] | [target] | [connection] | pending | |',
+                '',
+                '## Requirements Coverage',
+                '| Requirement | Status | Blocking Issue |',
+                '|-------------|--------|----------------|',
+                '| [req] | pending | |',
+                '',
+                '## Result',
+                '[Pending verification]',
+            ].join('\n');
+            fileName = `${padded}-VERIFICATION.md`;
+            break;
+        }
+        default:
+            (0, core_cjs_1.error)(`Unknown template type: ${templateType}. Available: summary, plan, verification`);
+            return;
+    }
+    const fullContent = `---\n${(0, frontmatter_cjs_1.reconstructFrontmatter)(frontmatter)}\n---\n\n${body}\n`;
+    const outPath = path_1.default.join(cwd, phaseInfo.directory, fileName);
+    if (fs_1.default.existsSync(outPath)) {
+        (0, core_cjs_1.output)({ error: 'File already exists', path: (0, core_cjs_1.toPosixPath)(path_1.default.relative(cwd, outPath)) }, raw);
+        return;
+    }
+    fs_1.default.writeFileSync(outPath, fullContent, 'utf-8');
+    const relPath = (0, core_cjs_1.toPosixPath)(path_1.default.relative(cwd, outPath));
+    (0, core_cjs_1.output)({ created: true, path: relPath, template: templateType }, raw, relPath);
+}
+//# sourceMappingURL=template.cjs.map

package/core/bin/lib/template.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.cjs","sourceRoot":"","sources":["template.cts"],"names":[],"mappings":"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"}

package/core/bin/lib/template.cts

@@ -0,0 +1,229 @@
+/**
+ * Template — Template selection and fill operations
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { normalizePhaseName, findPhaseInternal, generateSlugInternal, toPosixPath, output, error } from './core.cjs';
+import { reconstructFrontmatter } from './frontmatter.cjs';
+
+export function cmdTemplateSelect(cwd: string, planPath: string | undefined, raw: boolean): void {
+  if (!planPath) {
+    error('plan-path required');
+  }
+
+  try {
+    const fullPath = path.join(cwd, planPath!);
+    const content = fs.readFileSync(fullPath, 'utf-8');
+
+    // Simple heuristics
+    const taskMatch = content.match(/###\s*Task\s*\d+/g) || [];
+    const taskCount = taskMatch.length;
+
+    const decisionMatch = content.match(/decision/gi) || [];
+    const hasDecisions = decisionMatch.length > 0;
+
+    // Count file mentions
+    const fileMentions = new Set<string>();
+    const filePattern = /`([^`]+\.[a-zA-Z]+)`/g;
+    let m: RegExpExecArray | null;
+    while ((m = filePattern.exec(content)) !== null) {
+      if (m[1].includes('/') && !m[1].startsWith('http')) {
+        fileMentions.add(m[1]);
+      }
+    }
+    const fileCount = fileMentions.size;
+
+    let template = 'templates/summary-standard.md';
+    let type = 'standard';
+
+    if (taskCount <= 2 && fileCount <= 3 && !hasDecisions) {
+      template = 'templates/summary-minimal.md';
+      type = 'minimal';
+    } else if (hasDecisions || fileCount > 6 || taskCount > 5) {
+      template = 'templates/summary-complex.md';
+      type = 'complex';
+    }
+
+    const result = { template, type, taskCount, fileCount, hasDecisions };
+    output(result, raw, template);
+  } catch (e) {
+    // Fallback to standard
+    output({ template: 'templates/summary-standard.md', type: 'standard', error: (e as Error).message }, raw, 'templates/summary-standard.md');
+  }
+}
+
+interface TemplateFillOptions {
+  phase: string | null;
+  plan?: string | null;
+  name?: string | null;
+  type?: string | null;
+  wave?: string | null;
+  fields?: Record<string, unknown>;
+}
+
+export function cmdTemplateFill(cwd: string, templateType: string | undefined, options: TemplateFillOptions, raw: boolean): void {
+  if (!templateType) { error('template type required: summary, plan, or verification'); }
+  if (!options.phase) { error('--phase required'); }
+
+  const phaseInfo = findPhaseInternal(cwd, options.phase);
+  if (!phaseInfo || !phaseInfo.found) { output({ error: 'Phase not found', phase: options.phase }, raw); return; }
+
+  const padded = normalizePhaseName(options.phase);
+  const today = new Date().toISOString().split('T')[0];
+  const phaseName = options.name || phaseInfo.phase_name || 'Unnamed';
+  const phaseSlug = phaseInfo.phase_slug || generateSlugInternal(phaseName);
+  const phaseId = `${padded}-${phaseSlug}`;
+  const planNum = (options.plan || '01').padStart(2, '0');
+  const fields = options.fields || {};
+
+  let frontmatter: Record<string, unknown>, body: string, fileName: string;
+
+  switch (templateType) {
+    case 'summary': {
+      frontmatter = {
+        phase: phaseId,
+        plan: planNum,
+        subsystem: '[primary category]',
+        tags: [],
+        provides: [],
+        affects: [],
+        'tech-stack': { added: [], patterns: [] },
+        'key-files': { created: [], modified: [] },
+        'key-decisions': [],
+        'patterns-established': [],
+        duration: '[X]min',
+        completed: today,
+        ...fields,
+      };
+      body = [
+        `# Phase ${options.phase}: ${phaseName} Summary`,
+        '',
+        '**[Substantive one-liner describing outcome]**',
+        '',
+        '## Performance',
+        '- **Duration:** [time]',
+        '- **Tasks:** [count completed]',
+        '- **Files modified:** [count]',
+        '',
+        '## Accomplishments',
+        '- [Key outcome 1]',
+        '- [Key outcome 2]',
+        '',
+        '## Task Commits',
+        '1. **Task 1: [task name]** - `hash`',
+        '',
+        '## Files Created/Modified',
+        '- `path/to/file.ts` - What it does',
+        '',
+        '## Decisions & Deviations',
+        '[Key decisions or "None - followed plan as specified"]',
+        '',
+        '## Next Phase Readiness',
+        '[What\'s ready for next phase]',
+      ].join('\n');
+      fileName = `${padded}-${planNum}-SUMMARY.md`;
+      break;
+    }
+    case 'plan': {
+      const planType = options.type || 'execute';
+      const wave = parseInt(options.wave || '1') || 1;
+      frontmatter = {
+        phase: phaseId,
+        plan: planNum,
+        type: planType,
+        wave,
+        depends_on: [],
+        files_modified: [],
+        autonomous: true,
+        user_setup: [],
+        must_haves: { truths: [], artifacts: [], key_links: [] },
+        ...fields,
+      };
+      body = [
+        `# Phase ${options.phase} Plan ${planNum}: [Title]`,
+        '',
+        '## Objective',
+        '- **What:** [What this plan builds]',
+        '- **Why:** [Why it matters for the phase goal]',
+        '- **Output:** [Concrete deliverable]',
+        '',
+        '## Context',
+        '@.planning/PROJECT.md',
+        '@.planning/ROADMAP.md',
+        '@.planning/STATE.md',
+        '',
+        '## Tasks',
+        '',
+        '<task type="code">',
+        '  <name>[Task name]</name>',
+        '  <files>[file paths]</files>',
+        '  <action>[What to do]</action>',
+        '  <verify>[How to verify]</verify>',
+        '  <done>[Definition of done]</done>',
+        '</task>',
+        '',
+        '## Verification',
+        '[How to verify this plan achieved its objective]',
+        '',
+        '## Success Criteria',
+        '- [ ] [Criterion 1]',
+        '- [ ] [Criterion 2]',
+      ].join('\n');
+      fileName = `${padded}-${planNum}-PLAN.md`;
+      break;
+    }
+    case 'verification': {
+      frontmatter = {
+        phase: phaseId,
+        verified: new Date().toISOString(),
+        status: 'pending',
+        score: '0/0 must-haves verified',
+        ...fields,
+      };
+      body = [
+        `# Phase ${options.phase}: ${phaseName} — Verification`,
+        '',
+        '## Observable Truths',
+        '| # | Truth | Status | Evidence |',
+        '|---|-------|--------|----------|',
+        '| 1 | [Truth] | pending | |',
+        '',
+        '## Required Artifacts',
+        '| Artifact | Expected | Status | Details |',
+        '|----------|----------|--------|---------|',
+        '| [path] | [what] | pending | |',
+        '',
+        '## Key Link Verification',
+        '| From | To | Via | Status | Details |',
+        '|------|----|----|--------|---------|',
+        '| [source] | [target] | [connection] | pending | |',
+        '',
+        '## Requirements Coverage',
+        '| Requirement | Status | Blocking Issue |',
+        '|-------------|--------|----------------|',
+        '| [req] | pending | |',
+        '',
+        '## Result',
+        '[Pending verification]',
+      ].join('\n');
+      fileName = `${padded}-VERIFICATION.md`;
+      break;
+    }
+    default:
+      error(`Unknown template type: ${templateType}. Available: summary, plan, verification`);
+      return;
+  }
+
+  const fullContent = `---\n${reconstructFrontmatter(frontmatter)}\n---\n\n${body}\n`;
+  const outPath = path.join(cwd, phaseInfo.directory!, fileName);
+
+  if (fs.existsSync(outPath)) {
+    output({ error: 'File already exists', path: toPosixPath(path.relative(cwd, outPath)) }, raw);
+    return;
+  }
+
+  fs.writeFileSync(outPath, fullContent, 'utf-8');
+  const relPath = toPosixPath(path.relative(cwd, outPath));
+  output({ created: true, path: relPath, template: templateType }, raw, relPath);
+}

package/core/bin/lib/template.d.cts

@@ -0,0 +1,15 @@
+/**
+ * Template — Template selection and fill operations
+ */
+export declare function cmdTemplateSelect(cwd: string, planPath: string | undefined, raw: boolean): void;
+interface TemplateFillOptions {
+    phase: string | null;
+    plan?: string | null;
+    name?: string | null;
+    type?: string | null;
+    wave?: string | null;
+    fields?: Record<string, unknown>;
+}
+export declare function cmdTemplateFill(cwd: string, templateType: string | undefined, options: TemplateFillOptions, raw: boolean): void;
+export {};
+//# sourceMappingURL=template.d.cts.map

package/core/bin/lib/template.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.cts","sourceRoot":"","sources":["template.cts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CA4C/F;AAED,UAAU,mBAAmB;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,mBAAmB,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAoK/H"}