@planu/cli 1.11.0 → 1.13.0

package/dist/engine/project-dna/stack-detector.js

@@ -0,0 +1,309 @@
+// Planu — project-dna/stack-detector.ts
+// Detects project stack by reading manifest files.
+import { readFile, access } from 'node:fs/promises';
+import { join } from 'node:path';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+async function fileExists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function readFileIfExists(filePath) {
+    try {
+        return await readFile(filePath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Stack detection
+// ---------------------------------------------------------------------------
+/**
+ * Detects the technology stack by reading common manifest files.
+ * Returns normalized stack tokens (e.g. 'nextjs', 'supabase', 'vitest').
+ */
+export async function detectStack(projectPath) {
+    const tokens = new Set();
+    await detectFromPackageJson(projectPath, tokens);
+    await detectFromRequirements(projectPath, tokens);
+    await detectFromCargo(projectPath, tokens);
+    await detectFromGoMod(projectPath, tokens);
+    await detectFromTsConfig(projectPath, tokens);
+    await detectFromCiCd(projectPath, tokens);
+    return Array.from(tokens);
+}
+async function detectFromPackageJson(projectPath, tokens) {
+    const content = await readFileIfExists(join(projectPath, 'package.json'));
+    if (content === null) {
+        return;
+    }
+    let pkg;
+    try {
+        pkg = JSON.parse(content);
+    }
+    catch {
+        return;
+    }
+    if (typeof pkg !== 'object' || pkg === null) {
+        return;
+    }
+    const record = pkg;
+    const deps = {
+        ...(typeof record.dependencies === 'object' && record.dependencies !== null
+            ? record.dependencies
+            : {}),
+        ...(typeof record.devDependencies === 'object' && record.devDependencies !== null
+            ? record.devDependencies
+            : {}),
+    };
+    const mappings = [
+        ['next', 'nextjs'],
+        ['react', 'react'],
+        ['@supabase/supabase-js', 'supabase'],
+        ['@supabase/ssr', 'supabase'],
+        ['vitest', 'vitest'],
+        ['jest', 'jest'],
+        ['@prisma/client', 'prisma'],
+        ['prisma', 'prisma'],
+        ['stripe', 'stripe'],
+        ['zod', 'zod'],
+        ['typescript', 'typescript'],
+        ['vue', 'vue'],
+        ['svelte', 'svelte'],
+        ['express', 'express'],
+        ['fastify', 'fastify'],
+        ['drizzle-orm', 'drizzle'],
+        ['tailwindcss', 'tailwind'],
+        ['@trpc/server', 'trpc'],
+        ['graphql', 'graphql'],
+        ['mongoose', 'mongoose'],
+        ['sequelize', 'sequelize'],
+        ['redis', 'redis'],
+        ['ioredis', 'redis'],
+        ['@nestjs/core', 'nestjs'],
+        ['electron', 'electron'],
+    ];
+    for (const [dep, token] of mappings) {
+        if (dep in deps) {
+            tokens.add(token);
+        }
+    }
+}
+async function detectFromRequirements(projectPath, tokens) {
+    const content = await readFileIfExists(join(projectPath, 'requirements.txt'));
+    if (content === null) {
+        return;
+    }
+    const lines = content.toLowerCase();
+    const mappings = [
+        ['fastapi', 'fastapi'],
+        ['django', 'django'],
+        ['flask', 'flask'],
+        ['pydantic', 'pydantic'],
+        ['sqlalchemy', 'sqlalchemy'],
+        ['alembic', 'alembic'],
+        ['pytest', 'pytest'],
+        ['celery', 'celery'],
+        ['uvicorn', 'uvicorn'],
+    ];
+    for (const [keyword, token] of mappings) {
+        if (lines.includes(keyword)) {
+            tokens.add(token);
+        }
+    }
+}
+async function detectFromCargo(projectPath, tokens) {
+    const content = await readFileIfExists(join(projectPath, 'Cargo.toml'));
+    if (content === null) {
+        return;
+    }
+    const text = content.toLowerCase();
+    const mappings = [
+        ['actix', 'actix'],
+        ['axum', 'axum'],
+        ['tokio', 'tokio'],
+        ['serde', 'serde'],
+        ['diesel', 'diesel'],
+        ['sqlx', 'sqlx'],
+    ];
+    for (const [keyword, token] of mappings) {
+        if (text.includes(keyword)) {
+            tokens.add(token);
+        }
+    }
+}
+async function detectFromGoMod(projectPath, tokens) {
+    const content = await readFileIfExists(join(projectPath, 'go.mod'));
+    if (content === null) {
+        return;
+    }
+    const text = content.toLowerCase();
+    const mappings = [
+        ['gin-gonic/gin', 'gin'],
+        ['labstack/echo', 'echo'],
+        ['gofiber/fiber', 'fiber'],
+        ['gorm.io', 'gorm'],
+    ];
+    for (const [keyword, token] of mappings) {
+        if (text.includes(keyword)) {
+            tokens.add(token);
+        }
+    }
+}
+async function detectFromTsConfig(projectPath, tokens) {
+    const content = await readFileIfExists(join(projectPath, 'tsconfig.json'));
+    if (content === null) {
+        return;
+    }
+    try {
+        const parsed = JSON.parse(content);
+        if (typeof parsed !== 'object' || parsed === null) {
+            return;
+        }
+        const record = parsed;
+        const compilerOptions = record.compilerOptions;
+        if (typeof compilerOptions === 'object' && compilerOptions !== null) {
+            const opts = compilerOptions;
+            if (opts.strict === true) {
+                tokens.add('typescript-strict');
+            }
+        }
+    }
+    catch {
+        // malformed tsconfig, skip
+    }
+}
+async function detectFromCiCd(projectPath, tokens) {
+    const githubWorkflows = join(projectPath, '.github', 'workflows');
+    if (await fileExists(githubWorkflows)) {
+        tokens.add('github-actions');
+    }
+    if (await fileExists(join(projectPath, '.gitlab-ci.yml'))) {
+        tokens.add('gitlab-ci');
+    }
+}
+/**
+ * Detects the package manager by checking lock files and manifests.
+ */
+export async function detectPackageManager(projectPath) {
+    const checks = [
+        ['pnpm-lock.yaml', 'pnpm'],
+        ['yarn.lock', 'yarn'],
+        ['bun.lockb', 'bun'],
+        ['bun.lock', 'bun'],
+        ['package-lock.json', 'npm'],
+        ['Cargo.lock', 'cargo'],
+        ['go.sum', 'go'],
+        ['requirements.txt', 'pip'],
+        ['Pipfile.lock', 'pip'],
+        ['poetry.lock', 'pip'],
+    ];
+    for (const [file, pm] of checks) {
+        if (await fileExists(join(projectPath, file))) {
+            return pm;
+        }
+    }
+    if (await fileExists(join(projectPath, 'package.json'))) {
+        return 'npm';
+    }
+    return 'unknown';
+}
+// ---------------------------------------------------------------------------
+// Testing framework detection
+// ---------------------------------------------------------------------------
+/**
+ * Detects the primary testing framework based on stack tokens and config files.
+ */
+export async function detectTestingFramework(projectPath, stack) {
+    if (stack.includes('vitest')) {
+        return 'vitest';
+    }
+    if (stack.includes('jest')) {
+        return 'jest';
+    }
+    if (stack.includes('pytest')) {
+        return 'pytest';
+    }
+    // Go test is always available if go.mod exists
+    if (await fileExists(join(projectPath, 'go.mod'))) {
+        return 'go-test';
+    }
+    return undefined;
+}
+// ---------------------------------------------------------------------------
+// Linter detection
+// ---------------------------------------------------------------------------
+/**
+ * Detects the primary linter based on config files and stack tokens.
+ */
+export async function detectLinter(projectPath, stack) {
+    const eslintFiles = [
+        'eslint.config.js',
+        'eslint.config.mjs',
+        'eslint.config.ts',
+        '.eslintrc.js',
+        '.eslintrc.json',
+        '.eslintrc.yml',
+        '.eslintrc.yaml',
+    ];
+    for (const f of eslintFiles) {
+        if (await fileExists(join(projectPath, f))) {
+            return 'eslint';
+        }
+    }
+    if (stack.includes('fastapi') || stack.includes('django') || stack.includes('flask')) {
+        if (await fileExists(join(projectPath, 'pyproject.toml'))) {
+            const content = await readFileIfExists(join(projectPath, 'pyproject.toml'));
+            if (content?.includes('ruff') === true) {
+                return 'ruff';
+            }
+        }
+        return 'ruff';
+    }
+    if (await fileExists(join(projectPath, '.golangci.yml'))) {
+        return 'golangci-lint';
+    }
+    if (await fileExists(join(projectPath, 'Cargo.toml'))) {
+        return 'clippy';
+    }
+    return undefined;
+}
+// ---------------------------------------------------------------------------
+// Formatter detection
+// ---------------------------------------------------------------------------
+/**
+ * Detects the primary code formatter based on config files and stack tokens.
+ */
+export async function detectFormatter(projectPath, stack) {
+    const prettierFiles = [
+        'prettier.config.js',
+        'prettier.config.mjs',
+        '.prettierrc',
+        '.prettierrc.json',
+        '.prettierrc.yml',
+        '.prettierrc.yaml',
+    ];
+    for (const f of prettierFiles) {
+        if (await fileExists(join(projectPath, f))) {
+            return 'prettier';
+        }
+    }
+    if (stack.includes('fastapi') || stack.includes('django') || stack.includes('flask')) {
+        return 'black';
+    }
+    if (await fileExists(join(projectPath, 'go.mod'))) {
+        return 'gofmt';
+    }
+    if (await fileExists(join(projectPath, 'Cargo.toml'))) {
+        return 'rustfmt';
+    }
+    return undefined;
+}
+//# sourceMappingURL=stack-detector.js.map

package/dist/engine/project-dna/stack-detector.js.map

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

package/dist/engine/similar-problems/similarity-finder.d.ts

@@ -0,0 +1,3 @@
+import type { SimilarProblemsResult } from '../../types/index.js';
+export declare function findSimilarProblems(query: string, projectPath: string, specId?: string): Promise<SimilarProblemsResult>;
+//# sourceMappingURL=similarity-finder.d.ts.map

package/dist/engine/similar-problems/similarity-finder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"similarity-finder.d.ts","sourceRoot":"","sources":["../../../src/engine/similar-problems/similarity-finder.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAEV,qBAAqB,EAEtB,MAAM,sBAAsB,CAAC;AAyG9B,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,qBAAqB,CAAC,CAiDhC"}

package/dist/engine/similar-problems/similarity-finder.js

@@ -0,0 +1,144 @@
+// engine/similar-problems/similarity-finder.ts — SPEC-405
+// Find specs similar to a given description across all registered projects.
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { glob } from 'glob';
+import { getProjects } from '../../storage/global-projects-store.js';
+import { parseFrontmatter } from '../frontmatter-parser.js';
+// ---------------------------------------------------------------------------
+// Tokenization + Jaccard similarity
+// ---------------------------------------------------------------------------
+const STOP_WORDS = new Set([
+    'a',
+    'an',
+    'the',
+    'and',
+    'or',
+    'but',
+    'in',
+    'on',
+    'at',
+    'to',
+    'for',
+    'of',
+    'with',
+    'by',
+    'from',
+    'is',
+    'are',
+    'was',
+    'were',
+    'be',
+    'been',
+    'as',
+    'that',
+    'this',
+    'it',
+    'its',
+    'we',
+    'i',
+    'you',
+    'he',
+    'she',
+    'they',
+]);
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]/g, ' ')
+        .split(/\s+/)
+        .filter((w) => w.length > 2 && !STOP_WORDS.has(w));
+}
+function jaccardSimilarity(a, b) {
+    const setA = new Set(a);
+    const setB = new Set(b);
+    let intersection = 0;
+    for (const word of setA) {
+        if (setB.has(word)) {
+            intersection++;
+        }
+    }
+    const union = setA.size + setB.size - intersection;
+    return union === 0 ? 0 : intersection / union;
+}
+// ---------------------------------------------------------------------------
+// Spec loading from a project path
+// ---------------------------------------------------------------------------
+async function loadSpecsFromProject(projectPath) {
+    let files;
+    try {
+        const pattern = join(projectPath, 'planu', 'specs', '*', 'spec.md');
+        files = await glob(pattern, { nodir: true });
+    }
+    catch {
+        return [];
+    }
+    const entries = [];
+    await Promise.all(files.map(async (filePath) => {
+        try {
+            const content = await readFile(filePath, 'utf-8');
+            const { metadata } = parseFrontmatter(content);
+            const specId = typeof metadata.id === 'string' ? metadata.id : '';
+            const title = typeof metadata.title === 'string' ? metadata.title : '';
+            if (!specId || !title) {
+                return;
+            }
+            const rawTags = metadata.tags;
+            const tags = Array.isArray(rawTags)
+                ? rawTags.filter((t) => typeof t === 'string')
+                : [];
+            const tokens = tokenize(`${title} ${tags.join(' ')}`);
+            entries.push({ specId, title, tags, projectPath, tokens });
+        }
+        catch {
+            // skip unreadable files
+        }
+    }));
+    return entries;
+}
+// ---------------------------------------------------------------------------
+// Public function
+// ---------------------------------------------------------------------------
+export async function findSimilarProblems(query, projectPath, specId) {
+    // Gather registered projects plus the current one
+    const registered = await getProjects();
+    const paths = new Set([projectPath, ...registered.map((p) => p.path)]);
+    // Load all specs across all projects
+    const allSpecs = [];
+    await Promise.all([...paths].map(async (p) => {
+        const specs = await loadSpecsFromProject(p);
+        allSpecs.push(...specs);
+    }));
+    // Build query tokens
+    const queryTokens = tokenize(specId ? `${specId} ${query}` : query);
+    const scored = [];
+    for (const entry of allSpecs) {
+        // Skip exact match by specId
+        if (specId && entry.specId === specId && entry.projectPath === projectPath) {
+            continue;
+        }
+        const score = jaccardSimilarity(queryTokens, entry.tokens);
+        if (score === 0) {
+            continue;
+        }
+        const keyMatches = queryTokens.filter((t) => entry.tokens.includes(t));
+        scored.push({
+            specId: entry.specId,
+            title: entry.title,
+            projectPath: entry.projectPath,
+            similarityScore: score,
+            keyMatches,
+            _score: score,
+        });
+    }
+    const results = scored
+        .sort((a, b) => b._score - a._score)
+        .slice(0, 5)
+        .map(({ _score: _, ...rest }) => rest);
+    return {
+        query,
+        results,
+        totalSearched: allSpecs.length,
+    };
+}
+//# sourceMappingURL=similarity-finder.js.map

package/dist/engine/similar-problems/similarity-finder.js.map

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

package/dist/engine/sync/asana-puller.d.ts

@@ -0,0 +1,9 @@
+import type { PmPullSyncResult, PmConflictStrategy } from '../../types/index.js';
+/**
+ * Pull updates from Asana into Planu.
+ *
+ * Compares current Planu spec status against Asana task completion state,
+ * detecting divergence and resolving conflicts per the chosen strategy.
+ */
+export declare function pullFromAsana(projectPath: string, conflictStrategy: PmConflictStrategy): Promise<PmPullSyncResult>;
+//# sourceMappingURL=asana-puller.d.ts.map

package/dist/engine/sync/asana-puller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asana-puller.d.ts","sourceRoot":"","sources":["../../../src/engine/sync/asana-puller.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAEhB,kBAAkB,EAEnB,MAAM,sBAAsB,CAAC;AAM9B;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,kBAAkB,GACnC,OAAO,CAAC,gBAAgB,CAAC,CA8D3B"}

package/dist/engine/sync/asana-puller.js

@@ -0,0 +1,91 @@
+import { getAsanaConfig, getAsanaSyncMap } from '../../storage/asana-config-store.js';
+import { getSpec } from '../../storage/spec-store.js';
+import { hashProjectPath } from '../../storage/base-store.js';
+import { resolveConflicts } from './conflict-resolver.js';
+/**
+ * Pull updates from Asana into Planu.
+ *
+ * Compares current Planu spec status against Asana task completion state,
+ * detecting divergence and resolving conflicts per the chosen strategy.
+ */
+export async function pullFromAsana(projectPath, conflictStrategy) {
+    const config = await getAsanaConfig(projectPath);
+    if (config === null) {
+        throw new Error('Asana not configured. Run configure_asana first.');
+    }
+    const projectId = hashProjectPath(projectPath);
+    const syncMap = await getAsanaSyncMap(projectPath);
+    const entries = Object.values(syncMap);
+    const pulled = [];
+    const rawConflicts = [];
+    const now = new Date().toISOString();
+    for (const entry of entries) {
+        const spec = await getSpec(projectId, entry.specId);
+        if (spec === null) {
+            continue;
+        }
+        const liveStatus = await fetchAsanaTaskStatus(config.token, entry.taskGid);
+        if (liveStatus === null) {
+            continue;
+        }
+        if (liveStatus === spec.status) {
+            continue;
+        }
+        rawConflicts.push({
+            specId: spec.id,
+            field: 'status',
+            planuValue: spec.status,
+            externalValue: liveStatus,
+            strategy: conflictStrategy,
+        });
+    }
+    const conflicts = resolveConflicts(rawConflicts, conflictStrategy);
+    for (const conflict of conflicts) {
+        if (conflict.resolution === 'external-applied') {
+            pulled.push({
+                externalId: syncMap[conflict.specId]?.taskGid ?? '',
+                externalTitle: conflict.specId,
+                specId: conflict.specId,
+                field: conflict.field,
+                oldValue: conflict.planuValue,
+                newValue: conflict.externalValue,
+                appliedAt: now,
+            });
+        }
+    }
+    return {
+        integration: 'asana',
+        pulled,
+        conflicts,
+        newSpecsCreated: [],
+        executedAt: now,
+    };
+}
+/**
+ * Fetch the current status of an Asana task via the Asana API.
+ * Returns a Planu-normalized status string or null on failure.
+ */
+async function fetchAsanaTaskStatus(token, taskGid) {
+    try {
+        const response = await fetch(`https://app.asana.com/api/1.0/tasks/${taskGid}?opt_fields=completed,name`, {
+            headers: {
+                Authorization: `Bearer ${token}`,
+                Accept: 'application/json',
+            },
+        });
+        if (!response.ok) {
+            return null;
+        }
+        const data = (await response.json());
+        const completed = data.data?.completed;
+        if (completed === undefined) {
+            return null;
+        }
+        // Map Asana task completion to Planu status
+        return completed ? 'done' : 'in-progress';
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=asana-puller.js.map

package/dist/engine/sync/asana-puller.js.map

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

package/dist/engine/sync/conflict-resolver.d.ts

@@ -0,0 +1,17 @@
+import type { PmSyncConflict, PmConflictStrategy } from '../../types/index.js';
+/**
+ * Resolve a single conflict using the given strategy.
+ *
+ * Strategies:
+ * - spec-wins      → Planu value is authoritative; external change is discarded.
+ * - external-wins  → External PM value is authoritative; applied to Planu.
+ * - newest-wins    → The most recently updated side wins. Falls back to spec-wins
+ *                    when timestamps are equal or unparseable.
+ * - manual         → Conflict is flagged for human review; no automatic resolution.
+ */
+export declare function resolveConflict(conflict: Omit<PmSyncConflict, 'resolution'>, strategy: PmConflictStrategy): PmSyncConflict;
+/**
+ * Resolve a list of conflicts using the given strategy.
+ */
+export declare function resolveConflicts(conflicts: Omit<PmSyncConflict, 'resolution'>[], strategy: PmConflictStrategy): PmSyncConflict[];
+//# sourceMappingURL=conflict-resolver.d.ts.map

package/dist/engine/sync/conflict-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict-resolver.d.ts","sourceRoot":"","sources":["../../../src/engine/sync/conflict-resolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/E;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,EAC5C,QAAQ,EAAE,kBAAkB,GAC3B,cAAc,CAGhB;AAqDD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,EAAE,EAC/C,QAAQ,EAAE,kBAAkB,GAC3B,cAAc,EAAE,CAElB"}