@planu/cli 1.1.1 → 1.2.0

package/dist/engine/global-rules-manager.d.ts

@@ -0,0 +1,10 @@
+import type { GlobalRule, GlobalRuleApplyResult, GlobalRulesSummary } from '../types/index.js';
+export declare function globalRulesDir(): string;
+export declare function createRule(slug: string, name: string, content: string, tags: string[], author?: string, version?: string): Promise<GlobalRule>;
+export declare function getRule(slug: string): Promise<GlobalRule | null>;
+export declare function updateRule(slug: string, updates: Partial<Pick<GlobalRule, 'name' | 'content' | 'tags' | 'version' | 'author'>>): Promise<GlobalRule | null>;
+export declare function deleteRule(slug: string): Promise<boolean>;
+export declare function listRules(): Promise<GlobalRulesSummary>;
+export declare function applyRule(slug: string, projectPath: string): Promise<GlobalRuleApplyResult>;
+export declare function exportRule(slug: string): Promise<string>;
+//# sourceMappingURL=global-rules-manager.d.ts.map

package/dist/engine/global-rules-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-rules-manager.d.ts","sourceRoot":"","sources":["../../src/engine/global-rules-manager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAM/F,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAyED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,SAAU,GAChB,OAAO,CAAC,UAAU,CAAC,CAerB;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAWtE;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC,CAAC,GACrF,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAa5B;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAW/D;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAgC7D;AAMD,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAyCjG;AAMD,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM9D"}

package/dist/engine/global-rules-manager.js

@@ -0,0 +1,214 @@
+// engine/global-rules-manager.ts — Global Steering Rules manager (SPEC-351)
+import { readFile, writeFile, readdir, unlink, mkdir } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join, dirname } from 'node:path';
+// ---------------------------------------------------------------------------
+// Paths
+// ---------------------------------------------------------------------------
+export function globalRulesDir() {
+    return join(homedir(), '.planu', 'global-rules');
+}
+function ruleFile(slug) {
+    return join(globalRulesDir(), `${slug}.md`);
+}
+// ---------------------------------------------------------------------------
+// Frontmatter helpers
+// ---------------------------------------------------------------------------
+function buildFrontmatter(rule) {
+    const tagsStr = rule.tags.map((t) => `  - ${t}`).join('\n');
+    const authorLine = rule.author !== undefined ? `author: "${rule.author}"\n` : '';
+    return [
+        '---',
+        `name: "${rule.name}"`,
+        `tags:`,
+        tagsStr,
+        `version: "${rule.version}"`,
+        authorLine.trim(),
+        `createdAt: "${rule.createdAt}"`,
+        `updatedAt: "${rule.updatedAt}"`,
+        '---',
+        '',
+        rule.content,
+    ].join('\n');
+}
+function parseFrontmatter(raw, slug) {
+    const match = /^---\n([\s\S]*?)\n---\n([\s\S]*)$/m.exec(raw);
+    if (match === null) {
+        return {
+            slug,
+            name: slug,
+            content: raw,
+            tags: [],
+            version: '1.0.0',
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+        };
+    }
+    const fm = match[1] ?? '';
+    const content = (match[2] ?? '').trim();
+    const nameMatch = /^name:\s*"?([^"\n]+)"?/m.exec(fm);
+    const versionMatch = /^version:\s*"?([^"\n]+)"?/m.exec(fm);
+    const authorMatch = /^author:\s*"?([^"\n]+)"?/m.exec(fm);
+    const createdMatch = /^createdAt:\s*"?([^"\n]+)"?/m.exec(fm);
+    const updatedMatch = /^updatedAt:\s*"?([^"\n]+)"?/m.exec(fm);
+    const tagMatches = [...fm.matchAll(/^\s{2}-\s+(.+)$/gm)].map((m) => m[1]?.trim() ?? '');
+    return {
+        slug,
+        name: nameMatch?.[1]?.trim() ?? slug,
+        content,
+        tags: tagMatches,
+        version: versionMatch?.[1]?.trim() ?? '1.0.0',
+        author: authorMatch?.[1]?.trim(),
+        createdAt: createdMatch?.[1]?.trim() ?? new Date().toISOString(),
+        updatedAt: updatedMatch?.[1]?.trim() ?? new Date().toISOString(),
+    };
+}
+// ---------------------------------------------------------------------------
+// CRUD operations
+// ---------------------------------------------------------------------------
+async function ensureRulesDir() {
+    await mkdir(globalRulesDir(), { recursive: true });
+}
+export async function createRule(slug, name, content, tags, author, version = '1.0.0') {
+    await ensureRulesDir();
+    const now = new Date().toISOString();
+    const rule = {
+        slug,
+        name,
+        content,
+        tags,
+        version,
+        author,
+        createdAt: now,
+        updatedAt: now,
+    };
+    await writeFile(ruleFile(slug), buildFrontmatter(rule), 'utf-8');
+    return rule;
+}
+export async function getRule(slug) {
+    try {
+        const raw = await readFile(ruleFile(slug), 'utf-8');
+        return parseFrontmatter(raw, slug);
+    }
+    catch (err) {
+        if (err instanceof Error && 'code' in err && err.code === 'ENOENT') {
+            return null;
+        }
+        /* v8 ignore next */
+        throw err;
+    }
+}
+export async function updateRule(slug, updates) {
+    const existing = await getRule(slug);
+    if (existing === null) {
+        return null;
+    }
+    const updated = {
+        ...existing,
+        ...updates,
+        updatedAt: new Date().toISOString(),
+    };
+    await writeFile(ruleFile(slug), buildFrontmatter(updated), 'utf-8');
+    return updated;
+}
+export async function deleteRule(slug) {
+    try {
+        await unlink(ruleFile(slug));
+        return true;
+    }
+    catch (err) {
+        if (err instanceof Error && 'code' in err && err.code === 'ENOENT') {
+            return false;
+        }
+        /* v8 ignore next */
+        throw err;
+    }
+}
+export async function listRules() {
+    await ensureRulesDir();
+    let entries;
+    try {
+        entries = await readdir(globalRulesDir());
+    }
+    catch {
+        /* v8 ignore next */
+        return { totalRules: 0, rules: [] };
+    }
+    const mdFiles = entries.filter((e) => e.endsWith('.md'));
+    const rules = await Promise.all(mdFiles.map(async (file) => {
+        const slug = file.replace(/\.md$/, '');
+        const rule = await getRule(slug);
+        return rule;
+    }));
+    const valid = rules.filter((r) => r !== null);
+    return {
+        totalRules: valid.length,
+        rules: valid.map(({ slug, name, tags, version, author, createdAt, updatedAt }) => ({
+            slug,
+            name,
+            tags,
+            version,
+            author,
+            createdAt,
+            updatedAt,
+        })),
+    };
+}
+// ---------------------------------------------------------------------------
+// Apply rule to project CLAUDE.md
+// ---------------------------------------------------------------------------
+export async function applyRule(slug, projectPath) {
+    const rule = await getRule(slug);
+    if (rule === null) {
+        throw new Error(`Rule "${slug}" not found. Use manage_global_rules with action "list" to see available rules.`);
+    }
+    const claudeMdPath = join(projectPath, 'CLAUDE.md');
+    let existing = '';
+    try {
+        existing = await readFile(claudeMdPath, 'utf-8');
+    }
+    catch {
+        // File doesn't exist yet — will create it
+    }
+    const sectionHeader = `## Applied Global Rules\n### ${rule.name}\n`;
+    const section = `\n\n${sectionHeader}${rule.content}`;
+    let updated;
+    if (existing.includes(`### ${rule.name}`)) {
+        // Replace existing section
+        const pattern = new RegExp(`### ${escapeRegex(rule.name)}[\\s\\S]*?(?=\n### |$)`, 'g');
+        updated = existing.replace(pattern, `### ${rule.name}\n${rule.content}`);
+    }
+    else if (existing.includes('## Applied Global Rules')) {
+        // Append to existing Applied section
+        updated = existing + `\n### ${rule.name}\n${rule.content}`;
+    }
+    else {
+        updated = existing + section;
+    }
+    await mkdir(dirname(claudeMdPath), { recursive: true });
+    await writeFile(claudeMdPath, updated, 'utf-8');
+    return {
+        slug,
+        name: rule.name,
+        appliedTo: claudeMdPath,
+        section: sectionHeader,
+        appliedAt: new Date().toISOString(),
+    };
+}
+// ---------------------------------------------------------------------------
+// Export
+// ---------------------------------------------------------------------------
+export async function exportRule(slug) {
+    const rule = await getRule(slug);
+    if (rule === null) {
+        throw new Error(`Rule "${slug}" not found.`);
+    }
+    return buildFrontmatter(rule);
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=global-rules-manager.js.map

package/dist/engine/global-rules-manager.js.map

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

package/dist/engine/knowledge-base.d.ts

@@ -0,0 +1,12 @@
+import type { Decision, Lesson, Spec, ScoredDecision, ScoredSpec, ExtractedLesson, KnowledgeGap, KnowledgeSummary } from '../types/index.js';
+/** Search decisions by relevance to a query string. */
+export declare function searchDecisions(decisions: Decision[], query: string, limit?: number): ScoredDecision[];
+/** Find specs with similar keywords in title and description. */
+export declare function findSimilarProblems(specs: Spec[], query: string, limit?: number): ScoredSpec[];
+/** Extract lesson-like phrases from free-form text (retrospective, post-mortem). */
+export declare function extractLessonsFromText(text: string): ExtractedLesson[];
+/** Detect specs without decisions and lesson category gaps. */
+export declare function detectKnowledgeGaps(specs: Spec[], decisions: Decision[], lessons: Lesson[]): KnowledgeGap[];
+/** Snapshot of project knowledge. */
+export declare function buildKnowledgeSummary(specs: Spec[], decisions: Decision[], lessons: Lesson[]): KnowledgeSummary;
+//# sourceMappingURL=knowledge-base.d.ts.map

package/dist/engine/knowledge-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-base.d.ts","sourceRoot":"","sources":["../../src/engine/knowledge-base.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,QAAQ,EACR,MAAM,EACN,IAAI,EACJ,cAAc,EACd,UAAU,EACV,eAAe,EACf,YAAY,EACZ,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAwF3B,uDAAuD;AACvD,wBAAgB,eAAe,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,cAAc,EAAE,CAiCjG;AAMD,iEAAiE;AACjE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,UAAU,EAAE,CA2BzF;AAwBD,oFAAoF;AACpF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE,CAqBtE;AAWD,+DAA+D;AAC/D,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,IAAI,EAAE,EACb,SAAS,EAAE,QAAQ,EAAE,EACrB,OAAO,EAAE,MAAM,EAAE,GAChB,YAAY,EAAE,CA2ChB;AAMD,qCAAqC;AACrC,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,IAAI,EAAE,EACb,SAAS,EAAE,QAAQ,EAAE,EACrB,OAAO,EAAE,MAAM,EAAE,GAChB,gBAAgB,CA0BlB"}

package/dist/engine/knowledge-base.js

@@ -0,0 +1,250 @@
+// ---------------------------------------------------------------------------
+// TF-IDF tokenizer
+// ---------------------------------------------------------------------------
+const STOP_WORDS = new Set([
+    'the',
+    'a',
+    'an',
+    'and',
+    'or',
+    'but',
+    'in',
+    'on',
+    'at',
+    'to',
+    'for',
+    'of',
+    'with',
+    'by',
+    'from',
+    'is',
+    'was',
+    'are',
+    'were',
+    'be',
+    'been',
+    'that',
+    'this',
+    'it',
+    'its',
+    'we',
+    'i',
+    'you',
+    'he',
+    'she',
+    'they',
+    'not',
+    'no',
+    'do',
+    'did',
+    'does',
+    'have',
+    'had',
+    'has',
+    'will',
+    'would',
+    'can',
+    'could',
+    'should',
+    'may',
+    'might',
+    'as',
+    'so',
+    'if',
+    'when',
+]);
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]/g, ' ')
+        .split(/\s+/)
+        .filter((w) => w.length > 2 && !STOP_WORDS.has(w));
+}
+function termFrequency(tokens) {
+    const freq = new Map();
+    for (const t of tokens) {
+        freq.set(t, (freq.get(t) ?? 0) + 1);
+    }
+    return freq;
+}
+function overlapScore(queryTerms, docTerms) {
+    if (queryTerms.length === 0 || docTerms.length === 0) {
+        return 0;
+    }
+    const docSet = new Set(docTerms);
+    const matched = queryTerms.filter((t) => docSet.has(t)).length;
+    return matched / queryTerms.length;
+}
+// ---------------------------------------------------------------------------
+// Semantic decision search (TF-IDF based)
+// ---------------------------------------------------------------------------
+/** Search decisions by relevance to a query string. */
+export function searchDecisions(decisions, query, limit = 5) {
+    const queryTerms = tokenize(query);
+    if (queryTerms.length === 0) {
+        return [];
+    }
+    const scored = [];
+    for (const d of decisions) {
+        const docText = `${d.what} ${d.why} ${d.alternatives.join(' ')}`;
+        const docTerms = tokenize(docText);
+        const freqMap = termFrequency(docTerms);
+        // Simple relevance: weighted term overlap
+        let score = 0;
+        for (const qt of queryTerms) {
+            const tf = freqMap.get(qt) ?? 0;
+            score += tf;
+        }
+        if (score === 0) {
+            continue;
+        }
+        score = score / Math.max(docTerms.length, 1);
+        scored.push({
+            specId: d.specId ?? 'global',
+            title: d.what,
+            content: d.why,
+            relevanceScore: score,
+        });
+    }
+    return scored.sort((a, b) => b.relevanceScore - a.relevanceScore).slice(0, limit);
+}
+// ---------------------------------------------------------------------------
+// Similar problems finder
+// ---------------------------------------------------------------------------
+/** Find specs with similar keywords in title and description. */
+export function findSimilarProblems(specs, query, limit = 5) {
+    const queryTerms = tokenize(query);
+    if (queryTerms.length === 0) {
+        return [];
+    }
+    const scored = [];
+    for (const spec of specs) {
+        const docText = `${spec.title} ${spec.slug} ${spec.tags.join(' ')}`;
+        const docTerms = tokenize(docText);
+        const score = overlapScore(queryTerms, docTerms);
+        if (score === 0) {
+            continue;
+        }
+        const matchedTerms = queryTerms.filter((t) => docTerms.includes(t));
+        scored.push({
+            specId: spec.id,
+            title: spec.title,
+            overlapScore: score,
+            matchedTerms,
+        });
+    }
+    return scored.sort((a, b) => b.overlapScore - a.overlapScore).slice(0, limit);
+}
+// ---------------------------------------------------------------------------
+// Lesson extraction from text
+// ---------------------------------------------------------------------------
+/** Patterns that indicate a lesson in free-form text. */
+const LESSON_PATTERNS = [
+    { pattern: /aprendimos que[^.!?]*/gi, category: 'process' },
+    { pattern: /el problema fue[^.!?]*/gi, category: 'architecture' },
+    { pattern: /deber[ií]amos[^.!?]*/gi, category: 'process' },
+    { pattern: /we learned that[^.!?]*/gi, category: 'process' },
+    { pattern: /the problem was[^.!?]*/gi, category: 'architecture' },
+    { pattern: /we should[^.!?]*/gi, category: 'process' },
+    { pattern: /always [a-z][^.!?]*/gi, category: 'process' },
+    { pattern: /never [a-z][^.!?]*/gi, category: 'process' },
+    { pattern: /evitar[^.!?]*/gi, category: 'process' },
+    { pattern: /avoid[^.!?]*/gi, category: 'process' },
+    { pattern: /siempre [a-z][^.!?]*/gi, category: 'process' },
+    { pattern: /nunca [a-z][^.!?]*/gi, category: 'process' },
+    { pattern: /make sure[^.!?]*/gi, category: 'process' },
+    { pattern: /ensure that[^.!?]*/gi, category: 'process' },
+];
+/** Extract lesson-like phrases from free-form text (retrospective, post-mortem). */
+export function extractLessonsFromText(text) {
+    const lessons = [];
+    const seen = new Set();
+    for (const { pattern, category } of LESSON_PATTERNS) {
+        const matches = text.match(pattern) ?? [];
+        for (const match of matches) {
+            const cleaned = match.trim().replace(/\s+/g, ' ');
+            if (cleaned.length < 10) {
+                continue;
+            }
+            const key = cleaned.toLowerCase().slice(0, 50);
+            if (seen.has(key)) {
+                continue;
+            }
+            seen.add(key);
+            lessons.push({ text: cleaned, category });
+        }
+    }
+    return lessons;
+}
+// ---------------------------------------------------------------------------
+// Knowledge gap detector
+// ---------------------------------------------------------------------------
+/** List all unique lesson categories present. */
+function getLessonCategories(lessons) {
+    return new Set(lessons.map((l) => l.category));
+}
+/** Detect specs without decisions and lesson category gaps. */
+export function detectKnowledgeGaps(specs, decisions, lessons) {
+    const gaps = [];
+    // Specs without any associated decisions
+    const specsWithDecisions = new Set(decisions
+        .filter((d) => Boolean(d.specId))
+        .map((d) => d.specId));
+    for (const spec of specs) {
+        if (spec.status === 'done' && !specsWithDecisions.has(spec.id)) {
+            gaps.push({
+                type: 'spec-without-decisions',
+                specId: spec.id,
+                description: `Spec "${spec.title}" (${spec.id}) has no documented decisions.`,
+            });
+        }
+    }
+    // Categories with no lessons
+    const LESSON_CATEGORIES = [
+        'estimation',
+        'testing',
+        'architecture',
+        'security',
+        'performance',
+        'ux',
+        'process',
+    ];
+    const existingCategories = getLessonCategories(lessons);
+    for (const cat of LESSON_CATEGORIES) {
+        if (!existingCategories.has(cat)) {
+            gaps.push({
+                type: 'category-without-lessons',
+                category: cat,
+                description: `No lessons documented for category: "${cat}".`,
+            });
+        }
+    }
+    return gaps;
+}
+// ---------------------------------------------------------------------------
+// Knowledge summary
+// ---------------------------------------------------------------------------
+/** Snapshot of project knowledge. */
+export function buildKnowledgeSummary(specs, decisions, lessons) {
+    const specsWithDecisions = new Set(decisions
+        .filter((d) => Boolean(d.specId))
+        .map((d) => d.specId));
+    const catCounts = new Map();
+    for (const l of lessons) {
+        catCounts.set(l.category, (catCounts.get(l.category) ?? 0) + 1);
+    }
+    const topCategories = [...catCounts.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 5)
+        .map(([cat]) => cat);
+    const gaps = detectKnowledgeGaps(specs, decisions, lessons);
+    return {
+        totalDecisions: decisions.length,
+        totalLessons: lessons.length,
+        totalSpecs: specs.length,
+        specsWithDecisions: specsWithDecisions.size,
+        topCategories,
+        gaps,
+    };
+}
+//# sourceMappingURL=knowledge-base.js.map

package/dist/engine/knowledge-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-base.js","sourceRoot":"","sources":["../../src/engine/knowledge-base.ts"],"names":[],"mappings":"AAYA,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;IACzB,KAAK;IACL,GAAG;IACH,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,MAAM;IACN,IAAI;IACJ,MAAM;IACN,IAAI;IACJ,KAAK;IACL,KAAK;IACL,MAAM;IACN,IAAI;IACJ,MAAM;IACN,MAAM;IACN,MAAM;IACN,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,GAAG;IACH,KAAK;IACL,IAAI;IACJ,KAAK;IACL,MAAM;IACN,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,MAAM;IACN,MAAM;IACN,KAAK;IACL,KAAK;IACL,MAAM;IACN,OAAO;IACP,KAAK;IACL,OAAO;IACP,QAAQ;IACR,KAAK;IACL,OAAO;IACP,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,MAAM;CACP,CAAC,CAAC;AAEH,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI;SACR,WAAW,EAAE;SACb,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,aAAa,CAAC,MAAgB;IACrC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,YAAY,CAAC,UAAoB,EAAE,QAAkB;IAC5D,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrD,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/D,OAAO,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC;AACrC,CAAC;AAED,8EAA8E;AAC9E,0CAA0C;AAC1C,8EAA8E;AAE9E,uDAAuD;AACvD,MAAM,UAAU,eAAe,CAAC,SAAqB,EAAE,KAAa,EAAE,KAAK,GAAG,CAAC;IAC7E,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAqB,EAAE,CAAC;IAEpC,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACjE,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QACnC,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;QAExC,0CAA0C;QAC1C,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;YAC5B,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;YAChC,KAAK,IAAI,EAAE,CAAC;QACd,CAAC;QACD,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChB,SAAS;QACX,CAAC;QACD,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAE7C,MAAM,CAAC,IAAI,CAAC;YACV,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,QAAQ;YAC5B,KAAK,EAAE,CAAC,CAAC,IAAI;YACb,OAAO,EAAE,CAAC,CAAC,GAAG;YACd,cAAc,EAAE,KAAK;SACtB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,cAAc,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AACpF,CAAC;AAED,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E,iEAAiE;AACjE,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,KAAa,EAAE,KAAK,GAAG,CAAC;IACzE,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAiB,EAAE,CAAC;IAEhC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACpE,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,YAAY,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACjD,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChB,SAAS;QACX,CAAC;QAED,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAEpE,MAAM,CAAC,IAAI,CAAC;YACV,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,YAAY,EAAE,KAAK;YACnB,YAAY;SACb,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAChF,CAAC;AAED,8EAA8E;AAC9E,8BAA8B;AAC9B,8EAA8E;AAE9E,yDAAyD;AACzD,MAAM,eAAe,GAA4C;IAC/D,EAAE,OAAO,EAAE,yBAAyB,EAAE,QAAQ,EAAE,SAAS,EAAE;IAC3D,EAAE,OAAO,EAAE,0BAA0B,EAAE,QAAQ,EAAE,cAAc,EAAE;IACjE,EAAE,OAAO,EAAE,wBAAwB,EAAE,QAAQ,EAAE,SAAS,EAAE;IAC1D,EAAE,OAAO,EAAE,0BAA0B,EAAE,QAAQ,EAAE,SAAS,EAAE;IAC5D,EAAE,OAAO,EAAE,0BAA0B,EAAE,QAAQ,EAAE,cAAc,EAAE;IACjE,EAAE,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,SAAS,EAAE;IACtD,EAAE,OAAO,EAAE,uBAAuB,EAAE,QAAQ,EAAE,SAAS,EAAE;IACzD,EAAE,OAAO,EAAE,sBAAsB,EAAE,QAAQ,EAAE,SAAS,EAAE;IACxD,EAAE,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,SAAS,EAAE;IACnD,EAAE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,SAAS,EAAE;IAClD,EAAE,OAAO,EAAE,wBAAwB,EAAE,QAAQ,EAAE,SAAS,EAAE;IAC1D,EAAE,OAAO,EAAE,sBAAsB,EAAE,QAAQ,EAAE,SAAS,EAAE;IACxD,EAAE,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,SAAS,EAAE;IACtD,EAAE,OAAO,EAAE,sBAAsB,EAAE,QAAQ,EAAE,SAAS,EAAE;CACzD,CAAC;AAEF,oFAAoF;AACpF,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,MAAM,OAAO,GAAsB,EAAE,CAAC;IACtC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,KAAK,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,eAAe,EAAE,CAAC;QACpD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAC1C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YAClD,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;gBACxB,SAAS;YACX,CAAC;YACD,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/C,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClB,SAAS;YACX,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E,iDAAiD;AACjD,SAAS,mBAAmB,CAAC,OAAiB;IAC5C,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,mBAAmB,CACjC,KAAa,EACb,SAAqB,EACrB,OAAiB;IAEjB,MAAM,IAAI,GAAmB,EAAE,CAAC;IAEhC,yCAAyC;IACzC,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAChC,SAAS;SACN,MAAM,CAAC,CAAC,CAAC,EAAsC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;SACpE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CACxB,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAC/D,IAAI,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,wBAAwB;gBAC9B,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,WAAW,EAAE,SAAS,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,EAAE,gCAAgC;aAC9E,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,6BAA6B;IAC7B,MAAM,iBAAiB,GAAa;QAClC,YAAY;QACZ,SAAS;QACT,cAAc;QACd,UAAU;QACV,aAAa;QACb,IAAI;QACJ,SAAS;KACV,CAAC;IACF,MAAM,kBAAkB,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAExD,KAAK,MAAM,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,0BAA0B;gBAChC,QAAQ,EAAE,GAAG;gBACb,WAAW,EAAE,wCAAwC,GAAG,IAAI;aAC7D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,qCAAqC;AACrC,MAAM,UAAU,qBAAqB,CACnC,KAAa,EACb,SAAqB,EACrB,OAAiB;IAEjB,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAChC,SAAS;SACN,MAAM,CAAC,CAAC,CAAC,EAAsC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;SACpE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CACxB,CAAC;IAEF,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAClE,CAAC;IACD,MAAM,aAAa,GAAG,CAAC,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;SAC3C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;SAC3B,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;IAEvB,MAAM,IAAI,GAAG,mBAAmB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAE5D,OAAO;QACL,cAAc,EAAE,SAAS,CAAC,MAAM;QAChC,YAAY,EAAE,OAAO,CAAC,MAAM;QAC5B,UAAU,EAAE,KAAK,CAAC,MAAM;QACxB,kBAAkB,EAAE,kBAAkB,CAAC,IAAI;QAC3C,aAAa;QACb,IAAI;KACL,CAAC;AACJ,CAAC"}

package/dist/engine/monday-sync.d.ts

@@ -0,0 +1,10 @@
+import type { MondayConfig, PmSyncItemRef, MondaySpec } from '../types/index.js';
+export declare function createMondayItem(config: MondayConfig, spec: MondaySpec): Promise<PmSyncItemRef>;
+export declare function updateMondayItem(config: MondayConfig, itemId: string, spec: MondaySpec, columnValues?: Record<string, string>): Promise<void>;
+export declare function specToMondaySpec(spec: {
+    id: string;
+    title: string;
+    status?: string;
+    description?: string;
+}): MondaySpec;
+//# sourceMappingURL=monday-sync.d.ts.map

package/dist/engine/monday-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monday-sync.d.ts","sourceRoot":"","sources":["../../src/engine/monday-sync.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,UAAU,EAEX,MAAM,mBAAmB,CAAC;AA8B3B,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,aAAa,CAAC,CAgBxB;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,EAChB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC,CASf;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,UAAU,CAOb"}

package/dist/engine/monday-sync.js

@@ -0,0 +1,56 @@
+const MONDAY_API_URL = 'https://api.monday.com/v2';
+function buildHeaders(apiKey) {
+    return {
+        Authorization: apiKey,
+        'Content-Type': 'application/json',
+    };
+}
+async function runMutation(apiKey, query) {
+    const response = await fetch(MONDAY_API_URL, {
+        method: 'POST',
+        headers: buildHeaders(apiKey),
+        body: JSON.stringify({ query }),
+    });
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`Monday.com API error ${response.status}: ${text}`);
+    }
+    const data = (await response.json());
+    if (data.errors !== undefined && data.errors.length > 0) {
+        throw new Error(`Monday.com GraphQL error: ${data.errors[0]?.message ?? 'Unknown'}`);
+    }
+    return data;
+}
+export async function createMondayItem(config, spec) {
+    const title = `${spec.id}: ${spec.title}`.replace(/"/g, '\\"');
+    const query = `mutation { create_item(board_id: ${config.boardId}, item_name: "${title}") { id } }`;
+    const result = await runMutation(config.apiKey, query);
+    const itemId = result.data?.create_item?.id;
+    if (itemId === undefined) {
+        throw new Error('Monday.com did not return an item ID');
+    }
+    return {
+        specId: spec.id,
+        externalId: itemId,
+        externalUrl: `https://monday.com/boards/${config.boardId}/pulses/${itemId}`,
+        title: `${spec.id}: ${spec.title}`,
+    };
+}
+export async function updateMondayItem(config, itemId, spec, columnValues) {
+    const values = columnValues ?? {};
+    if (spec.status !== undefined) {
+        values.status = JSON.stringify({ label: spec.status });
+    }
+    const columnValuesJson = JSON.stringify(JSON.stringify(values));
+    const query = `mutation { change_multiple_column_values(board_id: ${config.boardId}, item_id: ${itemId}, column_values: ${columnValuesJson}) { id } }`;
+    await runMutation(config.apiKey, query);
+}
+export function specToMondaySpec(spec) {
+    return {
+        id: spec.id,
+        title: spec.title,
+        status: spec.status,
+        description: spec.description,
+    };
+}
+//# sourceMappingURL=monday-sync.js.map

package/dist/engine/monday-sync.js.map

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

package/dist/engine/notion-sync.d.ts

@@ -0,0 +1,13 @@
+import type { NotionConfig, NotionFieldMapping, NotionSpec, PmSyncItemRef } from '../types/index.js';
+export declare const DEFAULT_FIELD_MAPPING: NotionFieldMapping;
+export declare function createNotionPage(config: NotionConfig, spec: NotionSpec): Promise<PmSyncItemRef>;
+export declare function updateNotionPage(config: NotionConfig, pageId: string, spec: NotionSpec): Promise<void>;
+export declare function specToNotionSpec(spec: {
+    id: string;
+    title: string;
+    description?: string;
+    status?: string;
+    priority?: string;
+    tags?: string[];
+}): NotionSpec;
+//# sourceMappingURL=notion-sync.d.ts.map

package/dist/engine/notion-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notion-sync.d.ts","sourceRoot":"","sources":["../../src/engine/notion-sync.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACV,aAAa,EACd,MAAM,mBAAmB,CAAC;AAK3B,eAAO,MAAM,qBAAqB,EAAE,kBAMnC,CAAC;AAwCF,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,aAAa,CAAC,CAyBxB;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,GAAG,UAAU,CASb"}