@planu/cli 0.15.2

package/dist/tools/generate-docs/mobile-installation-guide.js

@@ -0,0 +1,136 @@
+// tools/generate-docs/mobile-installation-guide.ts — SPEC-013 criterion 15
+// Generates a mobile installation guide section when the project has iOS/Android specs.
+// SRP: builds the guide content string; detection lives in generate-docs.ts.
+// OCP: extend with new platform sections by adding helpers below — no changes to caller.
+// --- iOS section ---
+function buildTestFlightSection() {
+    return [
+        '### iOS — TestFlight Beta Distribution',
+        '',
+        '#### Prerequisites',
+        '- Active Apple Developer Program membership ($99/year)',
+        '- App ID registered in App Store Connect',
+        '- Distribution certificate and provisioning profile configured in Xcode',
+        '',
+        '#### Step 1: Archive the app',
+        '```bash',
+        '# Via Fastlane (recommended)',
+        'fastlane gym --scheme MyApp --export_method app-store',
+        '',
+        '# Via Xcode CLI',
+        'xcodebuild -project MyApp.xcodeproj -scheme MyApp \\',
+        '  -archivePath build/MyApp.xcarchive archive',
+        'xcodebuild -exportArchive -archivePath build/MyApp.xcarchive \\',
+        '  -exportOptionsPlist ExportOptions.plist \\',
+        '  -exportPath build/ipa',
+        '```',
+        '',
+        '#### Step 2: Upload to TestFlight',
+        '```bash',
+        'fastlane pilot upload --ipa build/ipa/MyApp.ipa',
+        '# Or via xcrun altool',
+        'xcrun altool --upload-app --type ios --file build/ipa/MyApp.ipa \\',
+        '  --apiKey <API_KEY> --apiIssuer <ISSUER_ID>',
+        '```',
+        '- App Store Connect → TestFlight → Invite internal testers (instant access)',
+        '- External beta: requires Apple beta review (1–3 business days)',
+        '',
+        '#### App Store Submission Checklist',
+        '- [ ] App icon 1024×1024 (no alpha channel)',
+        '- [ ] Screenshots for all required device sizes',
+        '- [ ] App Privacy details filled in App Store Connect',
+        '- [ ] `PrivacyInfo.xcprivacy` present if using required-reason APIs',
+        '- [ ] Export Compliance answered (encryption usage)',
+        '- [ ] Age rating and content descriptions set',
+        '- [ ] Phased Release enabled: Pricing & Availability → Phased Release',
+        '',
+        '> **Verification:** Build appears in TestFlight internal group.',
+        '> App Store Connect shows "Waiting for Review" after submission.',
+    ].join('\n');
+}
+// --- Android section ---
+function buildPlayStoreSection() {
+    return [
+        '### Android — APK Sideloading & Play Store Submission',
+        '',
+        '#### APK Sideloading (direct install)',
+        '```bash',
+        '# Build a debug APK for direct distribution',
+        './gradlew assembleDebug',
+        '# Output: app/build/outputs/apk/debug/app-debug.apk',
+        '',
+        '# Install on connected device',
+        'adb install app/build/outputs/apk/debug/app-debug.apk',
+        '',
+        '# Share APK for sideloading',
+        '# Recipient must enable: Settings → Security → Unknown Sources (or Install unknown apps)',
+        '```',
+        '',
+        '#### Google Play Store Submission Checklist',
+        '- [ ] Signed AAB (Android App Bundle) built with release keystore',
+        '',
+        '```bash',
+        '# Build signed AAB',
+        './gradlew bundleRelease',
+        '# Output: app/build/outputs/bundle/release/app-release.aab',
+        '',
+        '# Sign with keystore',
+        'jarsigner -verbose -sigalg SHA256withRSA -digestalg SHA-256 \\',
+        '  -keystore my-release-key.jks app-release.aab alias_name',
+        '',
+        '# Or via Fastlane supply',
+        'fastlane supply --aab app/build/outputs/bundle/release/app-release.aab \\',
+        '  --track internal',
+        '```',
+        '',
+        '- [ ] Play Console → App content → Privacy policy URL set',
+        '- [ ] Content rating questionnaire completed',
+        '- [ ] Target API level meets Play Store requirements (API 34+)',
+        '- [ ] 64-bit compliance verified: no 32-bit-only native libs',
+        '- [ ] Store listing: screenshots for phone + 7-inch + 10-inch tablets',
+        '- [ ] App Access instructions if login required for review',
+        '',
+        '> **Verification:** AAB uploaded to Internal Testing track.',
+        '> Play Console shows "Published" in Internal Testing. Test via Play Store app.',
+    ].join('\n');
+}
+// --- Phased rollout ---
+function buildPhasedRolloutSection() {
+    return [
+        '### Phased Rollout Strategy',
+        '',
+        '| Day | iOS (Phased Release) | Android (Play Console %) |',
+        '|-----|---------------------|--------------------------|',
+        '| 1   | 1% of users         | 1%                       |',
+        '| 2   | 2%                  | 5%                       |',
+        '| 3   | 5%                  | 10%                      |',
+        '| 4   | 10%                 | 20%                      |',
+        '| 5   | 20%                 | 50%                      |',
+        '| 6   | 50%                 | 100%                     |',
+        '| 7   | 100%                | (monitor)                |',
+        '',
+        '**Halt criteria:** Crash-free rate drops below 99.5% OR P1 issues exceed 0.1%.',
+        '- iOS: halt phased release in App Store Connect',
+        '- Android: halt rollout in Play Console; hotfix via expedited review',
+    ].join('\n');
+}
+// --- Main export ---
+/**
+ * Builds a mobile installation guide as a markdown string.
+ * Covers iOS (TestFlight + App Store checklist) and Android (APK + Play Store checklist).
+ * Called by handleGenerateDocs when specs include iOS/Android targets.
+ */
+export function generateMobileInstallationGuide(_knowledge, specs, _language) {
+    const hasIOS = specs.some((s) => s.target === 'ios');
+    const hasAndroid = specs.some((s) => s.target === 'android');
+    const sections = [];
+    if (hasIOS) {
+        sections.push(buildTestFlightSection());
+    }
+    if (hasAndroid) {
+        sections.push(buildPlayStoreSection());
+    }
+    sections.push(buildPhasedRolloutSection());
+    return sections.join('\n\n---\n\n');
+}
+//# sourceMappingURL=mobile-installation-guide.js.map

package/dist/tools/generate-docs/mobile-installation-guide.js.map

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

package/dist/tools/generate-docs.d.ts

@@ -0,0 +1,3 @@
+import type { GenerateDocsInput, ToolResult } from '../types/index.js';
+export declare function handleGenerateDocs(args: GenerateDocsInput): Promise<ToolResult>;
+//# sourceMappingURL=generate-docs.d.ts.map

package/dist/tools/generate-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-docs.d.ts","sourceRoot":"","sources":["../../src/tools/generate-docs.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAQ,MAAM,mBAAmB,CAAC;AAO7E,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAyJrF"}

package/dist/tools/generate-docs.js

@@ -0,0 +1,138 @@
+// tools/generate-docs.ts — Generate documentation
+// Uses doc-generator engine: generateDocs()
+import { t, ti } from '../i18n/index.js';
+import { knowledgeStore, specStore } from '../storage/index.js';
+import { generateDocs } from '../engine/doc-generator.js';
+import { generateAgentDocumentation } from './generate-docs/agent-docs-generator.js';
+import { generateBoundedContextMap } from './generate-docs/bounded-context-map-generator.js';
+import { generateMobileInstallationGuide } from './generate-docs/mobile-installation-guide.js';
+/** Returns true when any spec targets a native mobile platform. */
+function hasMobileSpecs(specs) {
+    return specs.some((s) => s.target === 'ios' || s.target === 'android');
+}
+export async function handleGenerateDocs(args) {
+    const { projectId, types: rawTypes, docType, specId, audience = 'developer', format = 'markdown', language = 'en', } = args;
+    // docType (singular) overrides types array — convenience shorthand for single-type generation
+    const types = docType ? [docType] : rawTypes;
+    const knowledge = await knowledgeStore.getKnowledge(projectId);
+    if (!knowledge) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: ti('errors.projectNotFound', { projectId }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Load specs for context
+    let specs = await specStore.listSpecs(projectId);
+    // If a specific specId was given, filter to that spec
+    if (specId) {
+        const singleSpec = specs.find((s) => s.id === specId);
+        if (singleSpec) {
+            specs = [singleSpec];
+        }
+    }
+    const result = generateDocs(types, knowledge, specs, audience, language);
+    // SPEC-016a: Generate agent documentation for agent projects (criterion 10)
+    const agentDocs = generateAgentDocumentation(knowledge, specs);
+    // SPEC-033: Generate bounded context map for DDD projects
+    const hasBoundedContextMap = types.includes('bounded-context-map');
+    const boundedContextMapContent = hasBoundedContextMap
+        ? await generateBoundedContextMap(knowledge.projectPath, knowledge)
+        : null;
+    // Format output
+    const lines = [
+        `## ${t('tools.generate_docs.description')}`,
+        '',
+        `**Types:** ${types.join(', ')}`,
+        `**Audience:** ${audience}`,
+        `**Format:** ${format}`,
+        `**Documents generated:** ${result.documents.length}`,
+        '',
+        `**${result.message}**`,
+        '',
+    ];
+    for (const doc of result.documents) {
+        lines.push(`---`);
+        lines.push('');
+        lines.push(`### ${doc.title}`);
+        lines.push('');
+        lines.push(`**Type:** ${doc.type} | **Path:** \`${doc.path}\` | **Audience:** ${doc.audience}`);
+        lines.push('');
+        if (doc.relatedSpecs.length > 0) {
+            lines.push(`**Related specs:** ${doc.relatedSpecs.join(', ')}`);
+            lines.push('');
+        }
+        // Show sections summary
+        if (doc.sections.length > 0) {
+            lines.push('**Sections:**');
+            for (const section of doc.sections) {
+                const indent = '  '.repeat(section.level - 1);
+                lines.push(`${indent}- ${section.title}`);
+            }
+            lines.push('');
+        }
+        // Show diagrams if any
+        if (doc.diagrams.length > 0) {
+            lines.push('**Diagrams:**');
+            for (const diagram of doc.diagrams) {
+                lines.push(`- ${diagram.title} (${diagram.type})`);
+            }
+            lines.push('');
+        }
+        // Show full content
+        lines.push('<details>');
+        lines.push(`<summary>Full content of ${doc.path}</summary>`);
+        lines.push('');
+        lines.push(doc.content);
+        lines.push('');
+        lines.push('</details>');
+        lines.push('');
+    }
+    const content = [
+        { type: 'text', text: lines.join('\n') },
+    ];
+    // SPEC-033: Append bounded context map if requested
+    if (boundedContextMapContent) {
+        content.push({
+            type: 'text',
+            text: ['---', '', '## Bounded Context Map (SPEC-033)', '', boundedContextMapContent].join('\n'),
+        });
+    }
+    // SPEC-016a: Append agent documentation sections if agent project
+    if (agentDocs) {
+        content.push({
+            type: 'text',
+            text: [
+                '---',
+                '',
+                '## Agent Documentation (SPEC-016a)',
+                '',
+                agentDocs.usageManual,
+                '',
+                '---',
+                '',
+                agentDocs.configurationGuide,
+                '',
+                '---',
+                '',
+                agentDocs.troubleshootingGuide,
+            ].join('\n'),
+        });
+    }
+    // SPEC-013 (criterion 15): Append mobile installation guide for iOS/Android specs
+    const mobileGuide = hasMobileSpecs(specs)
+        ? generateMobileInstallationGuide(knowledge, specs, language)
+        : null;
+    if (mobileGuide) {
+        content.push({
+            type: 'text',
+            text: ['---', '', '## Mobile Installation Guide (SPEC-013)', '', mobileGuide].join('\n'),
+        });
+    }
+    return { content };
+}
+//# sourceMappingURL=generate-docs.js.map

package/dist/tools/generate-docs.js.map

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

package/dist/tools/generate-execution-plan.d.ts

@@ -0,0 +1,3 @@
+import type { GenerateExecutionPlanInput, ToolResult } from '../types/index.js';
+export declare function handleGenerateExecutionPlan(args: GenerateExecutionPlanInput): Promise<ToolResult>;
+//# sourceMappingURL=generate-execution-plan.d.ts.map

package/dist/tools/generate-execution-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-execution-plan.d.ts","sourceRoot":"","sources":["../../src/tools/generate-execution-plan.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EACV,0BAA0B,EAK1B,UAAU,EACX,MAAM,mBAAmB,CAAC;AAE3B,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,0BAA0B,GAC/B,OAAO,CAAC,UAAU,CAAC,CA2ErB"}

package/dist/tools/generate-execution-plan.js

@@ -0,0 +1,130 @@
+// tools/generate-execution-plan.ts — Execution plan tool handler + orchestrator
+// SRP: this file owns only tool I/O and phase orchestration.
+// Phase logic lives in src/engine/execution-plan/phases.ts
+// Mobile distribution lives in src/engine/execution-plan/mobile-distribution.ts
+// Utilities live in src/engine/execution-plan/plan-utils.ts
+import { writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { specStore, knowledgeStore, patternStore } from '../storage/index.js';
+import { t, ti } from '../i18n/index.js';
+import { generatePlanMarkdown } from '../engine/dor-dod.js';
+import { generateSetupPhase, generateDataLayerPhase, generateBusinessLogicPhase, generateUIPhase, generateTestingPhase, generateIntegrationPhase, } from '../engine/execution-plan/phases.js';
+import { generateMobileDistributionPhase, isMobileDistributionSpec, } from '../engine/execution-plan/mobile-distribution.js';
+import { isDesktopReleaseSpec, generateDesktopDistributionPhase, } from '../engine/execution-plan/desktop-distribution.js';
+import { determineCriticalPath, findParallelizable, readSpecContent, } from '../engine/execution-plan/plan-utils.js';
+export async function handleGenerateExecutionPlan(args) {
+    const { specId, projectId } = args;
+    const spec = await specStore.getSpec(projectId, specId);
+    if (!spec) {
+        return {
+            content: [{ type: 'text', text: ti('spec.notFound', { id: specId }) }],
+            isError: true,
+        };
+    }
+    const knowledge = await knowledgeStore.getKnowledge(projectId);
+    if (!knowledge) {
+        return {
+            content: [{ type: 'text', text: t('project.notFound') }],
+            isError: true,
+        };
+    }
+    await patternStore.listPatterns(projectId);
+    const specContent = await readSpecContent(spec);
+    const phases = generatePhases(spec, knowledge, specContent);
+    const criticalPath = determineCriticalPath(phases);
+    const parallelizable = findParallelizable(phases);
+    const totalSteps = phases.reduce((sum, phase) => sum + phase.steps.length, 0);
+    const totalMinutes = phases.reduce((sum, phase) => sum + phase.steps.reduce((s, step) => s + step.estimatedMinutes, 0), 0);
+    const plan = { phases, totalSteps, criticalPath, parallelizable };
+    let planPath;
+    try {
+        const planDir = dirname(spec.huPath);
+        planPath = join(planDir, 'PLAN.md');
+        const planContent = generatePlanMarkdown(plan, spec);
+        await writeFile(planPath, planContent, 'utf-8');
+        await specStore.updateSpec(projectId, specId, { planPath });
+    }
+    catch {
+        planPath = undefined;
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: ti('tools.generate_execution_plan.success', {
+                    phaseCount: String(phases.length),
+                    stepCount: String(totalSteps),
+                }),
+            },
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    ...plan,
+                    planPath: planPath ?? null,
+                    summary: {
+                        phases: phases.length,
+                        totalSteps,
+                        estimatedMinutes: totalMinutes,
+                        estimatedHours: Math.round((totalMinutes / 60) * 10) / 10,
+                        criticalPathLength: criticalPath.length,
+                        parallelizableGroups: parallelizable.length,
+                    },
+                }, null, 2),
+            },
+        ],
+    };
+}
+// --- Phase dispatcher (OCP: add new phases here without modifying phase files) ---
+function generatePhases(spec, knowledge, specContent) {
+    const phases = [];
+    let stepOrder = 1;
+    const setupSteps = generateSetupPhase(spec, knowledge, stepOrder);
+    if (setupSteps.length > 0) {
+        phases.push({ name: 'Setup & Scaffolding', steps: setupSteps });
+        stepOrder += setupSteps.length;
+    }
+    if (spec.target === 'backend' || spec.target === 'fullstack' || spec.target === 'database') {
+        const dataSteps = generateDataLayerPhase(spec, knowledge, specContent, stepOrder);
+        if (dataSteps.length > 0) {
+            phases.push({ name: 'Data Layer', steps: dataSteps });
+            stepOrder += dataSteps.length;
+        }
+    }
+    if (spec.target !== 'frontend') {
+        const logicSteps = generateBusinessLogicPhase(spec, knowledge, specContent, stepOrder);
+        if (logicSteps.length > 0) {
+            phases.push({ name: 'Business Logic & API', steps: logicSteps });
+            stepOrder += logicSteps.length;
+        }
+    }
+    if (spec.target === 'frontend' || spec.target === 'fullstack') {
+        const uiSteps = generateUIPhase(spec, knowledge, specContent, stepOrder);
+        if (uiSteps.length > 0) {
+            phases.push({ name: 'UI Implementation', steps: uiSteps });
+            stepOrder += uiSteps.length;
+        }
+    }
+    const testSteps = generateTestingPhase(spec, knowledge, stepOrder);
+    phases.push({ name: 'Testing & Verification', steps: testSteps });
+    stepOrder += testSteps.length;
+    // SPEC-013: Distribution phase for mobile release specs (iOS/Android/Flutter/RN/Expo)
+    if (isMobileDistributionSpec(spec)) {
+        const distSteps = generateMobileDistributionPhase(spec, stepOrder);
+        if (distSteps.length > 0) {
+            phases.push({ name: 'Distribution & Store Submission', steps: distSteps });
+            stepOrder += distSteps.length;
+        }
+    }
+    // SPEC-014b: Distribution phase for desktop release specs
+    if (knowledge.projectCategory === 'desktop' && isDesktopReleaseSpec(spec)) {
+        const desktopDistSteps = generateDesktopDistributionPhase(spec, stepOrder);
+        if (desktopDistSteps.length > 0) {
+            phases.push({ name: 'Distribution', steps: desktopDistSteps });
+            stepOrder += desktopDistSteps.length;
+        }
+    }
+    const integrationSteps = generateIntegrationPhase(spec, knowledge, stepOrder);
+    phases.push({ name: 'Integration & Cleanup', steps: integrationSteps });
+    return phases;
+}
+//# sourceMappingURL=generate-execution-plan.js.map

package/dist/tools/generate-execution-plan.js.map

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

package/dist/tools/generate-orchestration-script.d.ts

@@ -0,0 +1,3 @@
+import type { GenerateOrchestrationScriptInput, ToolResult } from '../types/index.js';
+export declare function handleGenerateOrchestrationScript(args: GenerateOrchestrationScriptInput): ToolResult;
+//# sourceMappingURL=generate-orchestration-script.d.ts.map

package/dist/tools/generate-orchestration-script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-orchestration-script.d.ts","sourceRoot":"","sources":["../../src/tools/generate-orchestration-script.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gCAAgC,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEtF,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,gCAAgC,GACrC,UAAU,CAgDZ"}

package/dist/tools/generate-orchestration-script.js

@@ -0,0 +1,50 @@
+// tools/generate-orchestration-script.ts — SPEC-022 TD: 3-layer parallel automation script generator
+// Generates a bash orchestration script for parallel multi-agent execution via git worktrees.
+import { t } from '../i18n/index.js';
+import { generateOrchestrationScript } from './suggest-tooling/orchestration-generator.js';
+export function handleGenerateOrchestrationScript(args) {
+    const { specIds, projectPath, mainBranch, baseBranch } = args;
+    if (specIds.length === 0) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'Error: specIds must contain at least one spec ID.',
+                },
+            ],
+            isError: true,
+        };
+    }
+    const script = generateOrchestrationScript({ specIds, projectPath, mainBranch, baseBranch });
+    const lines = [
+        `## ${t('tools.generate_orchestration_script.description')}`,
+        '',
+        `**Specs:** ${specIds.join(', ')}`,
+        `**Project path:** ${projectPath}`,
+        `**Base branch:** ${baseBranch ?? 'develop'}`,
+        '',
+        '### Usage',
+        '',
+        '1. Save the script below to `scripts/parallel-specs.sh`',
+        '2. Make it executable: `chmod +x scripts/parallel-specs.sh`',
+        '3. Run: `bash scripts/parallel-specs.sh`',
+        '',
+        '### Generated Script',
+        '',
+        '```bash',
+        script,
+        '```',
+        '',
+        '### Architecture (3 Layers)',
+        '',
+        '- **Layer 1 — Skills**: Claude Code skill files (`.claude/skills/*.md`) define agent workflows',
+        '- **Layer 2 — Sub-agents**: Scoped agents generated by `generate_sub_agent` handle delegated tasks',
+        '- **Layer 3 — Orchestration**: This script coordinates parallel instances via git worktrees',
+        '',
+        '_Each sub-agent operates in isolation — no commits, no push, no tracking. The skill parent handles those steps._',
+    ];
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+    };
+}
+//# sourceMappingURL=generate-orchestration-script.js.map

package/dist/tools/generate-orchestration-script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-orchestration-script.js","sourceRoot":"","sources":["../../src/tools/generate-orchestration-script.ts"],"names":[],"mappings":"AAAA,qGAAqG;AACrG,8FAA8F;AAE9F,OAAO,EAAE,CAAC,EAAE,MAAM,kBAAkB,CAAC;AACrC,OAAO,EAAE,2BAA2B,EAAE,MAAM,8CAA8C,CAAC;AAG3F,MAAM,UAAU,iCAAiC,CAC/C,IAAsC;IAEtC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAE9D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,mDAAmD;iBAC1D;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,2BAA2B,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;IAE7F,MAAM,KAAK,GAAa;QACtB,MAAM,CAAC,CAAC,iDAAiD,CAAC,EAAE;QAC5D,EAAE;QACF,cAAc,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAClC,qBAAqB,WAAW,EAAE;QAClC,oBAAoB,UAAU,IAAI,SAAS,EAAE;QAC7C,EAAE;QACF,WAAW;QACX,EAAE;QACF,yDAAyD;QACzD,6DAA6D;QAC7D,0CAA0C;QAC1C,EAAE;QACF,sBAAsB;QACtB,EAAE;QACF,SAAS;QACT,MAAM;QACN,KAAK;QACL,EAAE;QACF,6BAA6B;QAC7B,EAAE;QACF,gGAAgG;QAChG,oGAAoG;QACpG,6FAA6F;QAC7F,EAAE;QACF,kHAAkH;KACnH,CAAC;IAEF,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;KAC7D,CAAC;AACJ,CAAC"}

package/dist/tools/generate-rules.d.ts

@@ -0,0 +1,3 @@
+import type { GenerateRulesInput, ToolResult } from '../types/index.js';
+export declare function handleGenerateRules(args: GenerateRulesInput): Promise<ToolResult>;
+//# sourceMappingURL=generate-rules.d.ts.map

package/dist/tools/generate-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-rules.d.ts","sourceRoot":"","sources":["../../src/tools/generate-rules.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAExE,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CAqGvF"}

package/dist/tools/generate-rules.js

@@ -0,0 +1,91 @@
+// tools/generate-rules.ts — Generate project rules for AI agents
+// Uses skill-generator engine: generateRules()
+import { t, ti } from '../i18n/index.js';
+import { knowledgeStore } from '../storage/index.js';
+import { generateRules } from '../engine/skill-generator.js';
+import { fetchRecommendedSkills } from './suggest-tooling/skills-fetcher.js';
+export async function handleGenerateRules(args) {
+    const { projectId, platform, includeArchitecture = true, includeConventions = true, includeQuality = true, includeWorkflow = true, customRules = [], } = args;
+    const knowledge = await knowledgeStore.getKnowledge(projectId);
+    if (!knowledge) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: ti('errors.projectNotFound', { projectId }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Optionally load constitution for richer rules
+    const constitution = await knowledgeStore.getConstitution(projectId);
+    // Auto-fetch recommended skills from skills.sh based on project stack
+    const recommendedSkills = await fetchRecommendedSkills(knowledge);
+    const result = await generateRules(platform, knowledge, constitution ?? undefined, {
+        includeArchitecture,
+        includeConventions,
+        includeQuality,
+        includeWorkflow,
+        customRules,
+        recommendedSkills,
+    });
+    // Format output
+    const lines = [
+        `## ${t('tools.generate_rules.description')}`,
+        '',
+        `**Platform:** ${result.platform}`,
+        `**Rules count:** ${result.rulesCount}`,
+        `**Categories:** ${result.categories.join(', ')}`,
+        '',
+    ];
+    // Main rules file
+    lines.push(`### Rules File: \`${result.rulesFile.path}\``);
+    lines.push('');
+    lines.push(`\`\`\`${result.rulesFile.format}\``);
+    lines.push(result.rulesFile.content);
+    lines.push('```');
+    lines.push('');
+    // Additional files
+    if (result.additionalFiles.length > 0) {
+        lines.push('### Additional Files');
+        lines.push('');
+        for (const file of result.additionalFiles) {
+            lines.push(`#### \`${file.path}\``);
+            lines.push('');
+            lines.push(`\`\`\`${file.format}\``);
+            lines.push(file.content);
+            lines.push('```');
+            lines.push('');
+        }
+    }
+    // Recommended skills with install commands
+    if (result.recommendedSkills.length > 0) {
+        lines.push('### Recommended Skills (auto-detected)');
+        lines.push('');
+        lines.push('Install these skills to enhance your AI agent capabilities:');
+        lines.push('');
+        for (const skill of result.recommendedSkills) {
+            lines.push(`- **${skill.name}**: ${skill.description}`);
+            lines.push(`  - Install: \`${skill.installCommand}\``);
+        }
+        lines.push('');
+    }
+    // Instructions
+    lines.push('### Usage');
+    lines.push('');
+    lines.push(`Save the rules file to \`${result.rulesFile.path}\` in your project root.`);
+    if (result.additionalFiles.length > 0) {
+        lines.push(`Also save the ${result.additionalFiles.length} additional file(s) listed above.`);
+    }
+    if (result.recommendedSkills.length > 0) {
+        lines.push('');
+        lines.push('**Install the recommended skills above** to get stack-specific best practices.');
+    }
+    lines.push('');
+    lines.push('The AI agent will automatically pick up these rules when working on the project.');
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+    };
+}
+//# sourceMappingURL=generate-rules.js.map

package/dist/tools/generate-rules.js.map

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

package/dist/tools/generate-skill.d.ts

@@ -0,0 +1,3 @@
+import type { GenerateSkillInput, ToolResult } from '../types/index.js';
+export declare function handleGenerateSkill(args: GenerateSkillInput): Promise<ToolResult>;
+//# sourceMappingURL=generate-skill.d.ts.map

package/dist/tools/generate-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-skill.d.ts","sourceRoot":"","sources":["../../src/tools/generate-skill.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAExE,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CAgEvF"}