@x0rium/devkit-cli 0.4.0

package/dist/investigate.js

@@ -0,0 +1,200 @@
+import { readFileSync, writeFileSync, existsSync, readdirSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+function getNextId(dir, prefix) {
+    if (!existsSync(dir))
+        return `${prefix}001`;
+    const files = readdirSync(dir)
+        .filter(f => f.startsWith(prefix) && f.endsWith('.md'))
+        .sort();
+    if (files.length === 0)
+        return `${prefix}001`;
+    const last = files[files.length - 1];
+    const numMatch = last.match(new RegExp(`${prefix}(\\d+)`));
+    if (!numMatch)
+        return `${prefix}001`;
+    const next = parseInt(numMatch[1], 10) + 1;
+    return `${prefix}${next.toString().padStart(3, '0')}`;
+}
+function findBrokenAssumption(cwd, keywords) {
+    const decisionsDir = join(cwd, '.devkit', 'arch', 'decisions');
+    if (!existsSync(decisionsDir))
+        return null;
+    const adrs = readdirSync(decisionsDir)
+        .filter(f => f.startsWith('ADR-') && f.endsWith('.md'));
+    for (const adrFile of adrs) {
+        const content = readFileSync(join(decisionsDir, adrFile), 'utf-8');
+        // Check if any keyword appears in the Assumptions section
+        const assumptionSection = content.split(/^## Assumptions/m)[1];
+        if (!assumptionSection)
+            continue;
+        // Only check up to the next ## section
+        const endIdx = assumptionSection.indexOf('\n## ');
+        const assumptionText = endIdx > 0 ? assumptionSection.slice(0, endIdx) : assumptionSection;
+        for (const keyword of keywords) {
+            if (assumptionText.toLowerCase().includes(keyword.toLowerCase())) {
+                return {
+                    adr: adrFile.replace('.md', ''),
+                    assumption: assumptionText.trim().split('\n')[0]?.trim() ?? '(see ADR)',
+                };
+            }
+        }
+    }
+    return null;
+}
+function findInvariantsAtRisk(cwd, keywords) {
+    const results = [];
+    for (const relPath of ['arch/invariants.md', 'product/ux_invariants.md']) {
+        const fullPath = join(cwd, '.devkit', relPath);
+        if (!existsSync(fullPath))
+            continue;
+        const content = readFileSync(fullPath, 'utf-8');
+        const sections = content.split(/^## /m).slice(1);
+        for (const section of sections) {
+            const header = section.split('\n')[0]?.trim() ?? '';
+            for (const keyword of keywords) {
+                if (section.toLowerCase().includes(keyword.toLowerCase())) {
+                    results.push(header);
+                    break;
+                }
+            }
+        }
+    }
+    return results;
+}
+export function createInvestigation(cwd, description) {
+    const devkitDir = join(cwd, '.devkit');
+    const decisionsDir = join(devkitDir, 'arch', 'decisions');
+    if (!existsSync(devkitDir)) {
+        return {
+            created: false, id: '', path: '', brokenAssumption: null,
+            adrSource: null, invariantsAtRisk: [],
+            error: '.devkit/ not found. Run "devkit init" first.',
+        };
+    }
+    mkdirSync(decisionsDir, { recursive: true });
+    // Extract keywords
+    const keywords = description
+        .toLowerCase()
+        .split(/[\s,;]+/)
+        .filter(w => w.length > 2)
+        .filter(w => !['the', 'and', 'for', 'with', 'from', 'that', 'this', 'into', 'bug', 'found', 'does', 'not'].includes(w));
+    // Try to find broken assumption in ADRs
+    const broken = findBrokenAssumption(cwd, keywords);
+    // Find invariants at risk
+    const invariantsAtRisk = findInvariantsAtRisk(cwd, keywords);
+    // Generate ID
+    const id = getNextId(decisionsDir, 'INV-');
+    const filename = `${id}.md`;
+    const filePath = join(decisionsDir, filename);
+    const today = new Date().toISOString().split('T')[0];
+    const lines = [];
+    lines.push(`# ${id}: ${description}`);
+    lines.push('');
+    lines.push(`DATE: ${today}`);
+    lines.push('STATUS: open');
+    lines.push(`TRIGGERED_BY: ${description}`);
+    lines.push('');
+    // Broken assumption
+    lines.push('## Broken Assumption');
+    if (broken) {
+        lines.push(`ASSUMPTION_IN: ${broken.adr}`);
+        lines.push(`ASSUMPTION_WAS: ${broken.assumption}`);
+    }
+    else {
+        lines.push('ASSUMPTION_IN: _not auto-detected — check ADRs manually_');
+        lines.push('ASSUMPTION_WAS: ');
+    }
+    lines.push('REALITY: ');
+    lines.push('');
+    // Impact
+    lines.push('## Impact');
+    if (invariantsAtRisk.length > 0) {
+        lines.push(`INVARIANTS_AT_RISK: [${invariantsAtRisk.join(', ')}]`);
+    }
+    else {
+        lines.push('INVARIANTS_AT_RISK: _none auto-detected_');
+    }
+    lines.push('SPECS_AFFECTED: []');
+    lines.push('');
+    // Options
+    lines.push('## Options');
+    lines.push('');
+    lines.push('### Option A: [workaround]');
+    lines.push('Description. Cost. Technical debt introduced.');
+    lines.push('');
+    lines.push('### Option B: [alternative approach]');
+    lines.push('Description. Cost. Technical debt introduced.');
+    lines.push('');
+    lines.push('### Option C: [accept limitation]');
+    lines.push('Description. Cost. Technical debt introduced.');
+    lines.push('');
+    // Decision
+    lines.push('## Decision');
+    lines.push('CHOSEN: ');
+    lines.push('RATIONALE: ');
+    lines.push('DECIDED_BY: ');
+    lines.push(`DATE_DECIDED: `);
+    lines.push('');
+    // Post-decision
+    lines.push('## Post-Decision Actions');
+    lines.push('- [ ] Update affected ADR or create new one');
+    lines.push('- [ ] Update invariants.md if changed');
+    lines.push('- [ ] Regenerate constitution (`devkit generate-constitution`)');
+    lines.push('- [ ] Update affected specs');
+    lines.push('- [ ] Document any technical debt');
+    lines.push('');
+    writeFileSync(filePath, lines.join('\n'), 'utf-8');
+    return {
+        created: true,
+        id,
+        path: `arch/decisions/${filename}`,
+        brokenAssumption: broken?.assumption ?? null,
+        adrSource: broken?.adr ?? null,
+        invariantsAtRisk,
+    };
+}
+export function listInvestigations(cwd) {
+    const decisionsDir = join(cwd, '.devkit', 'arch', 'decisions');
+    if (!existsSync(decisionsDir))
+        return [];
+    return readdirSync(decisionsDir)
+        .filter(f => f.startsWith('INV-') && f.endsWith('.md'))
+        .sort()
+        .map(f => {
+        const content = readFileSync(join(decisionsDir, f), 'utf-8');
+        const titleMatch = content.match(/^# (.+)/m);
+        const statusMatch = content.match(/^STATUS:\s*(.+)/m);
+        const dateMatch = content.match(/^DATE:\s*(.+)/m);
+        return {
+            id: f.replace('.md', ''),
+            title: titleMatch?.[1] ?? f,
+            status: statusMatch?.[1]?.trim() ?? 'unknown',
+            date: dateMatch?.[1]?.trim() ?? 'unknown',
+        };
+    });
+}
+export function resolveInvestigation(cwd, invId, option, rationale) {
+    const decisionsDir = join(cwd, '.devkit', 'arch', 'decisions');
+    const filePath = join(decisionsDir, `${invId}.md`);
+    if (!existsSync(filePath)) {
+        return { resolved: false, error: `${invId}.md not found in .devkit/arch/decisions/` };
+    }
+    const content = readFileSync(filePath, 'utf-8');
+    const today = new Date().toISOString().split('T')[0];
+    const lines = content.split('\n').map(line => {
+        if (line.startsWith('STATUS:'))
+            return 'STATUS: resolved';
+        if (line.startsWith('CHOSEN:'))
+            return `CHOSEN: ${option}`;
+        if (line.startsWith('RATIONALE:'))
+            return `RATIONALE: ${rationale}`;
+        if (line.startsWith('DECIDED_BY:'))
+            return 'DECIDED_BY: developer';
+        if (line.startsWith('DATE_DECIDED:'))
+            return `DATE_DECIDED: ${today}`;
+        return line;
+    });
+    writeFileSync(filePath, lines.join('\n'), 'utf-8');
+    return { resolved: true };
+}
+//# sourceMappingURL=investigate.js.map

package/dist/investigate.js.map

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

package/dist/rfc.d.ts

@@ -0,0 +1,21 @@
+export interface RfcResult {
+    created: boolean;
+    id: string;
+    path: string;
+    affectedInvariants: string[];
+    affectedSpecs: string[];
+    riskLevel: string;
+    error?: string;
+}
+export declare function createRfc(cwd: string, description: string): RfcResult;
+export declare function listRfcs(cwd: string): {
+    id: string;
+    title: string;
+    status: string;
+    date: string;
+}[];
+export declare function resolveRfc(cwd: string, rfcId: string, option: string, rationale: string): {
+    resolved: boolean;
+    error?: string;
+};
+//# sourceMappingURL=rfc.d.ts.map

package/dist/rfc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rfc.d.ts","sourceRoot":"","sources":["../src/rfc.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAmBD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,CAmGrE;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAmBnG;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAuB/H"}

package/dist/rfc.js

@@ -0,0 +1,152 @@
+import { readFileSync, writeFileSync, existsSync, readdirSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { analyzeImpact } from './impact.js';
+function getNextId(dir, prefix) {
+    if (!existsSync(dir))
+        return `${prefix}001`;
+    const files = readdirSync(dir)
+        .filter(f => f.startsWith(prefix) && f.endsWith('.md'))
+        .sort();
+    if (files.length === 0)
+        return `${prefix}001`;
+    const last = files[files.length - 1];
+    const numMatch = last.match(new RegExp(`${prefix}(\\d+)`));
+    if (!numMatch)
+        return `${prefix}001`;
+    const next = parseInt(numMatch[1], 10) + 1;
+    return `${prefix}${next.toString().padStart(3, '0')}`;
+}
+export function createRfc(cwd, description) {
+    const devkitDir = join(cwd, '.devkit');
+    const decisionsDir = join(devkitDir, 'arch', 'decisions');
+    if (!existsSync(devkitDir)) {
+        return {
+            created: false, id: '', path: '', affectedInvariants: [],
+            affectedSpecs: [], riskLevel: 'unknown',
+            error: '.devkit/ not found. Run "devkit init" first.',
+        };
+    }
+    // Ensure decisions directory exists
+    mkdirSync(decisionsDir, { recursive: true });
+    // Run impact analysis
+    const impact = analyzeImpact(cwd, description);
+    // Generate RFC ID
+    const id = getNextId(decisionsDir, 'RFC-');
+    const filename = `${id}.md`;
+    const filePath = join(decisionsDir, filename);
+    const today = new Date().toISOString().split('T')[0];
+    // Build RFC content from template
+    const lines = [];
+    lines.push(`# ${id}: ${description}`);
+    lines.push('');
+    lines.push(`DATE: ${today}`);
+    lines.push('STATUS: open');
+    lines.push(`TRIGGERED_BY: ${description}`);
+    lines.push('');
+    // Affected invariants (auto-populated from impact analysis)
+    lines.push('## Affected Invariants');
+    if (impact.affectedInvariants.length > 0) {
+        for (const inv of impact.affectedInvariants) {
+            lines.push(`- ${inv}`);
+        }
+    }
+    else {
+        lines.push('_No invariants directly affected (manual review recommended)_');
+    }
+    lines.push('');
+    // Affected specs
+    lines.push('## Affected Specs');
+    if (impact.affectedSpecs.length > 0) {
+        for (const spec of impact.affectedSpecs) {
+            lines.push(`- ${spec}`);
+        }
+    }
+    else {
+        lines.push('_No specs identified (check .specify/ manually)_');
+    }
+    lines.push('');
+    // Change cost
+    lines.push('## Change Cost');
+    lines.push(`SPECS_TO_REVISE: ${impact.affectedSpecs.length}`);
+    lines.push(`INVARIANTS_TO_CHANGE: ${impact.affectedInvariants.length}`);
+    lines.push('ESTIMATED_EFFORT: TODO');
+    lines.push('');
+    // Options (developer fills these)
+    lines.push('## Options');
+    lines.push('');
+    lines.push('### Option A: [name]');
+    lines.push('Description, pros, cons');
+    lines.push('');
+    lines.push('### Option B: [name]');
+    lines.push('Description, pros, cons');
+    lines.push('');
+    // Decision (to be filled)
+    lines.push('## Decision');
+    lines.push('CHOSEN: ');
+    lines.push('RATIONALE: ');
+    lines.push('DECIDED_BY: ');
+    lines.push(`DATE_DECIDED: `);
+    lines.push('');
+    // Post-decision checklist
+    lines.push('## Post-Decision Actions');
+    lines.push('- [ ] Update invariants.md');
+    lines.push('- [ ] Regenerate constitution (`devkit generate-constitution`)');
+    lines.push('- [ ] Sync constitution (`devkit sync`)');
+    lines.push('- [ ] Mark affected specs as NEEDS_REVISION');
+    lines.push('- [ ] Resume SpecKit');
+    lines.push('');
+    writeFileSync(filePath, lines.join('\n'), 'utf-8');
+    return {
+        created: true,
+        id,
+        path: `arch/decisions/${filename}`,
+        affectedInvariants: impact.affectedInvariants,
+        affectedSpecs: impact.affectedSpecs,
+        riskLevel: impact.riskLevel,
+    };
+}
+export function listRfcs(cwd) {
+    const decisionsDir = join(cwd, '.devkit', 'arch', 'decisions');
+    if (!existsSync(decisionsDir))
+        return [];
+    return readdirSync(decisionsDir)
+        .filter(f => f.startsWith('RFC-') && f.endsWith('.md'))
+        .sort()
+        .map(f => {
+        const content = readFileSync(join(decisionsDir, f), 'utf-8');
+        const titleMatch = content.match(/^# (.+)/m);
+        const statusMatch = content.match(/^STATUS:\s*(.+)/m);
+        const dateMatch = content.match(/^DATE:\s*(.+)/m);
+        return {
+            id: f.replace('.md', ''),
+            title: titleMatch?.[1] ?? f,
+            status: statusMatch?.[1]?.trim() ?? 'unknown',
+            date: dateMatch?.[1]?.trim() ?? 'unknown',
+        };
+    });
+}
+export function resolveRfc(cwd, rfcId, option, rationale) {
+    const decisionsDir = join(cwd, '.devkit', 'arch', 'decisions');
+    const filePath = join(decisionsDir, `${rfcId}.md`);
+    if (!existsSync(filePath)) {
+        return { resolved: false, error: `${rfcId}.md not found in .devkit/arch/decisions/` };
+    }
+    const content = readFileSync(filePath, 'utf-8');
+    const today = new Date().toISOString().split('T')[0];
+    const lines = content.split('\n').map(line => {
+        if (line.startsWith('STATUS:'))
+            return 'STATUS: accepted';
+        if (line.startsWith('CHOSEN:'))
+            return `CHOSEN: ${option}`;
+        if (line.startsWith('RATIONALE:'))
+            return `RATIONALE: ${rationale}`;
+        if (line.startsWith('DECIDED_BY:'))
+            return 'DECIDED_BY: developer';
+        if (line.startsWith('DATE_DECIDED:'))
+            return `DATE_DECIDED: ${today}`;
+        return line;
+    });
+    writeFileSync(filePath, lines.join('\n'), 'utf-8');
+    return { resolved: true };
+}
+//# sourceMappingURL=rfc.js.map

package/dist/rfc.js.map

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

package/dist/scaffold.d.ts

@@ -0,0 +1,7 @@
+export interface ScaffoldResult {
+    created: string[];
+    skipped: string[];
+    mode: string;
+}
+export declare function scaffoldDevkit(cwd: string, mode: string): ScaffoldResult;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AA2BA,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,CA6BxE"}

package/dist/scaffold.js

@@ -0,0 +1,54 @@
+import { mkdirSync, writeFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+const STATUS_TEMPLATE = `# DevKit Status
+
+MODE: {mode}
+INITIALIZED: {date}
+CURRENT_PHASE: research
+
+## Phase Status
+- [ ] ResearchKit
+- [ ] ProductKit
+- [ ] ArchKit
+- [ ] SpecKit
+- [ ] QAKit
+`;
+const DIRECTORIES = [
+    '.devkit',
+    '.devkit/research',
+    '.devkit/product',
+    '.devkit/arch',
+    '.devkit/arch/decisions',
+    '.devkit/qa',
+    '.devkit/qa/escalations',
+];
+export function scaffoldDevkit(cwd, mode) {
+    const created = [];
+    const skipped = [];
+    // Create directories
+    for (const dir of DIRECTORIES) {
+        const fullPath = join(cwd, dir);
+        if (!existsSync(fullPath)) {
+            mkdirSync(fullPath, { recursive: true });
+            created.push(dir + '/');
+        }
+        else {
+            skipped.push(dir + '/');
+        }
+    }
+    // Create STATUS.md
+    const statusPath = join(cwd, '.devkit', 'STATUS.md');
+    if (!existsSync(statusPath)) {
+        const today = new Date().toISOString().split('T')[0];
+        const content = STATUS_TEMPLATE
+            .replace('{mode}', mode)
+            .replace('{date}', today);
+        writeFileSync(statusPath, content, 'utf-8');
+        created.push('.devkit/STATUS.md');
+    }
+    else {
+        skipped.push('.devkit/STATUS.md');
+    }
+    return { created, skipped, mode };
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,eAAe,GAAG;;;;;;;;;;;;CAYvB,CAAC;AAEF,MAAM,WAAW,GAAG;IAChB,SAAS;IACT,kBAAkB;IAClB,iBAAiB;IACjB,cAAc;IACd,wBAAwB;IACxB,YAAY;IACZ,wBAAwB;CAC3B,CAAC;AAQF,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,IAAY;IACpD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,qBAAqB;IACrB,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxB,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;QAC5B,CAAC;aAAM,CAAC;YACJ,OAAO,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;QAC5B,CAAC;IACL,CAAC;IAED,mBAAmB;IACnB,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IACrD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,eAAe;aAC1B,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC;aACvB,OAAO,CAAC,QAAQ,EAAE,KAAM,CAAC,CAAC;QAC/B,aAAa,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC5C,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACtC,CAAC;SAAM,CAAC;QACJ,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACtC,CAAC"}

package/dist/schemas.d.ts

@@ -0,0 +1,11 @@
+export interface ArtifactSchema {
+    id: string;
+    file: string;
+    directory: string;
+    requiredSections: string[];
+    optionalSections?: string[];
+}
+export declare const SCHEMAS: ArtifactSchema[];
+export declare const STRUCTURED_FIELDS: Record<string, string[]>;
+export declare function getSchemaForFile(filename: string, directory: string): ArtifactSchema | undefined;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,eAAO,MAAM,OAAO,EAAE,cAAc,EAwFnC,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAStD,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEhG"}

package/dist/schemas.js

@@ -0,0 +1,103 @@
+// JSON Schemas for DevKit artifact validation
+// Each schema validates YAML frontmatter of the corresponding artifact
+export const SCHEMAS = [
+    // ResearchKit
+    {
+        id: 'research.market',
+        file: 'market.md',
+        directory: 'research',
+        requiredSections: ['Analogues', 'Unoccupied Space', 'Potential User'],
+    },
+    {
+        id: 'research.feasibility',
+        file: 'feasibility.md',
+        directory: 'research',
+        requiredSections: ['Known Approaches', 'Known Limitations', 'Verdict'],
+    },
+    {
+        id: 'research.unknowns',
+        file: 'unknowns.md',
+        directory: 'research',
+        requiredSections: [], // dynamic: each Unknown section has structured fields
+    },
+    {
+        id: 'research.assumptions',
+        file: 'assumptions.md',
+        directory: 'research',
+        requiredSections: [], // dynamic: each Assumption section has structured fields
+    },
+    // ProductKit
+    {
+        id: 'product.users',
+        file: 'users.md',
+        directory: 'product',
+        requiredSections: ['Primary User'],
+        optionalSections: ['Secondary User', 'Edge Cases'],
+    },
+    {
+        id: 'product.ux_invariants',
+        file: 'ux_invariants.md',
+        directory: 'product',
+        requiredSections: [], // dynamic: each U_N section has structured fields
+    },
+    {
+        id: 'product.roadmap',
+        file: 'roadmap.md',
+        directory: 'product',
+        requiredSections: ['MVP'],
+        optionalSections: ['V1', 'Later', 'Never'],
+    },
+    // ArchKit
+    {
+        id: 'arch.invariants',
+        file: 'invariants.md',
+        directory: 'arch',
+        requiredSections: [], // dynamic
+    },
+    {
+        id: 'arch.impact',
+        file: 'impact.md',
+        directory: 'arch',
+        requiredSections: [],
+    },
+    {
+        id: 'arch.constitution',
+        file: 'constitution.md',
+        directory: 'arch',
+        requiredSections: [],
+    },
+    // QAKit
+    {
+        id: 'qa.test_contracts',
+        file: 'test_contracts.md',
+        directory: 'qa',
+        requiredSections: [],
+    },
+    {
+        id: 'qa.coverage_map',
+        file: 'coverage_map.md',
+        directory: 'qa',
+        requiredSections: [],
+    },
+    {
+        id: 'qa.assumption_checks',
+        file: 'assumption_checks.md',
+        directory: 'qa',
+        requiredSections: [],
+    },
+];
+// Fields that should be present in structured sections (Unknown, Assumption, Invariant, etc.)
+export const STRUCTURED_FIELDS = {
+    'unknown': ['DESCRIPTION', 'RISK', 'VALIDATION', 'BLOCKER', 'STATUS'],
+    'assumption': ['STATEMENT', 'BASIS', 'RISK', 'VALIDATION_METHOD', 'STATUS'],
+    'invariant': ['STATEMENT', 'RATIONALE', 'VERIFICATION', 'FAILURE_MODE', 'STATUS'],
+    'ux_invariant': ['STATEMENT', 'RATIONALE', 'VALIDATION', 'PRIORITY', 'STATUS'],
+    'adr': ['CONTEXT', 'DECISION', 'CONSEQUENCES'],
+    'rfc': ['TRIGGER', 'AFFECTED_INVARIANTS', 'OPTIONS', 'STATUS'],
+    'investigation': ['TRIGGER', 'AFFECTED_ASSUMPTION', 'FINDING', 'OPTIONS', 'STATUS'],
+    'test_contract': ['INVARIANT', 'WHAT', 'HOW', 'VIOLATION', 'CRITICALITY'],
+};
+export function getSchemaForFile(filename, directory) {
+    return SCHEMAS.find(s => s.file === filename && s.directory === directory);
+}
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

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

package/dist/status.d.ts

@@ -0,0 +1,13 @@
+export type Phase = 'research' | 'product' | 'arch' | 'spec' | 'qa';
+export type PhaseStatus = 'pending' | 'in_progress' | 'done';
+export interface DevKitStatus {
+    phase: Phase;
+    mode: string;
+    initialized: string;
+    phaseProgress: Record<Phase, PhaseStatus>;
+    nextStep: string;
+    artifactCounts: Record<string, number>;
+}
+export declare function getStatus(cwd: string): DevKitStatus | null;
+export declare function formatStatus(status: DevKitStatus): string;
+//# sourceMappingURL=status.d.ts.map

package/dist/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,KAAK,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AACpE,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,aAAa,GAAG,MAAM,CAAC;AAoB7D,MAAM,WAAW,YAAY;IACzB,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAiBD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAyD1D;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CA4BzD"}