@bhimudev/gnanai 0.4.0

package/dist/scaffold/create-project-description.js

@@ -0,0 +1,104 @@
+import fs from 'fs-extra';
+export async function createProjectDescription(answers) {
+    const template = `# Project Description
+
+> This file provides context to all agents. Fill it in thoroughly.
+> After filling, run: \`archai generate\`
+
+## Project Overview
+
+**Name:** ${answers.projectName}
+
+**One-line description:**
+[What does this project do in one sentence?]
+
+**Detailed description:**
+[2-3 paragraphs explaining the project, its purpose, target users, and core functionality]
+
+## Tech Stack
+
+**Languages:** ${answers.languages || '[TODO: Add your languages - e.g., TypeScript, Python, Go]'}
+**Frameworks:** ${answers.frameworks || '[TODO: Add your frameworks - e.g., React, Express, Django]'}
+**Testing:** ${answers.testFramework || '[TODO: Add your test framework - e.g., vitest, jest, pytest]'}
+
+## Architecture
+
+**High-level architecture:**
+[Describe how the system is structured - client/server, microservices, monolith, etc.]
+
+\`\`\`
+[ASCII diagram of your architecture - optional but helpful]
+\`\`\`
+
+**Key modules/packages:**
+${answers.isMonorepo ? `- \`packages/\` - Shared libraries
+- \`apps/\` - Applications` : `- \`src/\` - Main source code`}
+
+## Domain Concepts
+
+**Core entities:**
+[List the main domain objects/concepts in your system]
+
+- **Entity1**: Description
+- **Entity2**: Description
+
+**Key workflows:**
+[Describe the main user flows or system processes]
+
+1. Workflow name: Brief description
+2. ...
+
+## Technical Constraints
+
+**Performance requirements:**
+- [e.g., "Must handle 1000 concurrent users"]
+- [e.g., "Page load under 3 seconds"]
+
+**Compatibility requirements:**
+- [e.g., "Modern browsers only", "iOS 14+"]
+
+**Security considerations:**
+- [e.g., "Authentication required", "Data encryption"]
+
+## Development Guidelines
+
+**Code style:**
+[Any specific conventions, patterns to follow - or reference to style guide]
+
+**What to avoid:**
+[Anti-patterns, deprecated approaches, things NOT to do]
+
+**Testing philosophy:**
+[How thorough should tests be? What must be tested?]
+
+## External Integrations
+
+List any third-party services/APIs:
+
+| Service | Purpose | Notes |
+|---------|---------|-------|
+| [Service name] | [What it's used for] | [Any special notes] |
+
+## Current State
+
+**What's working:**
+- [Feature 1]
+- [Feature 2]
+
+**Known issues:**
+- [Issue 1]
+- [Issue 2]
+
+**Upcoming priorities:**
+- [Priority 1]
+- [Priority 2]
+
+---
+
+> Delete this section after filling: This file is read by all agents.
+> The more detail you provide, the better the agents will understand your project.
+`;
+    await fs.ensureDir('.knowledge/context');
+    await fs.writeFile('.knowledge/context/project-description.md', template);
+}
+//# sourceMappingURL=create-project-description.js.map

package/dist/scaffold/create-project-description.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-project-description.js","sourceRoot":"","sources":["../../src/scaffold/create-project-description.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,UAAU,CAAC;AAY1B,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,OAAsB;IACnE,MAAM,QAAQ,GAAG;;;;;;;YAOP,OAAO,CAAC,WAAW;;;;;;;;;;iBAUd,OAAO,CAAC,SAAS,IAAI,2DAA2D;kBAC/E,OAAO,CAAC,UAAU,IAAI,4DAA4D;eACrF,OAAO,CAAC,aAAa,IAAI,8DAA8D;;;;;;;;;;;;EAYpG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;2BACI,CAAC,CAAC,CAAC,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiE5D,CAAC;IAEA,MAAM,EAAE,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;IACzC,MAAM,EAAE,CAAC,SAAS,CAAC,2CAA2C,EAAE,QAAQ,CAAC,CAAC;AAC5E,CAAC"}

package/dist/scaffold/create-structure.d.ts

@@ -0,0 +1,2 @@
+export declare function scaffoldProject(): Promise<void>;
+//# sourceMappingURL=create-structure.d.ts.map

package/dist/scaffold/create-structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-structure.d.ts","sourceRoot":"","sources":["../../src/scaffold/create-structure.ts"],"names":[],"mappings":"AAwCA,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAqBrD"}

package/dist/scaffold/create-structure.js

@@ -0,0 +1,146 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const FOLDERS = [
+    // Claude agent system
+    '.claude/agents',
+    '.claude/state',
+    '.claude/state/archived',
+    '.claude/plans',
+    '.claude/plans/archived',
+    '.claude/templates',
+    // Knowledge base
+    '.knowledge/context',
+    '.knowledge/decisions',
+    '.knowledge/learnings',
+    '.knowledge/constraints',
+    '.knowledge/patterns',
+    // Task management
+    '.tasks/inbox',
+    '.tasks/done',
+    '.tasks/epics',
+    '.tasks/review',
+    '.tasks/blocked',
+    '.tasks/templates',
+    // Supervisor (coordination)
+    '.supervisor',
+    // Agent scratch space
+    '.agents/plans',
+    '.agents/scratch',
+    '.agents/thoughts',
+];
+export async function scaffoldProject() {
+    // Create all folders
+    for (const folder of FOLDERS) {
+        await fs.ensureDir(folder);
+        // Add .gitkeep to preserve empty folders
+        await fs.writeFile(`${folder}/.gitkeep`, '');
+    }
+    // Create supervisor files
+    await fs.writeFile('.supervisor/assignments.md', '# Assignments\n\nNo active assignments.\n');
+    await fs.writeFile('.supervisor/merge-queue.md', '# Merge Queue\n\nNo branches in queue.\n');
+    await fs.writeFile('.supervisor/conflicts.md', '# Conflicts\n\nNo conflicts to resolve.\n');
+    // Create task templates
+    await createTaskTemplates();
+    // Update .gitignore
+    await updateGitignore();
+    // Copy template files to project root
+    await copyTemplateFiles();
+}
+async function copyTemplateFiles() {
+    const templateFiles = [
+        { src: 'PROMPTS.md', dest: 'PROMPTS.md' },
+        { src: 'ARCHAI_README.md', dest: 'ARCHAI_README.md' },
+    ];
+    for (const file of templateFiles) {
+        const templatePath = path.join(__dirname, '../../templates', file.src);
+        const destPath = file.dest;
+        // Only copy if file doesn't already exist
+        if (await fs.pathExists(destPath)) {
+            continue;
+        }
+        if (await fs.pathExists(templatePath)) {
+            await fs.copyFile(templatePath, destPath);
+        }
+    }
+}
+async function createTaskTemplates() {
+    const epicTemplate = `---
+id: TASK-XXX
+title: "[Epic Title]"
+type: epic
+priority: medium
+status: inbox
+created: YYYY-MM-DD
+due: null
+depends_on: []
+blocks: []
+assignee: null
+branch: null
+---
+
+## Description
+
+[Describe the feature, bug fix, or task in detail]
+
+## Acceptance Criteria
+
+- [ ] Criterion 1
+- [ ] Criterion 2
+- [ ] Criterion 3
+
+## Context
+
+[Links to relevant documentation, designs, related issues]
+
+## Technical Notes
+
+[Any technical considerations or constraints]
+`;
+    const subtaskTemplate = `---
+id: SUBTASK-XXX
+parent: TASK-XXX
+title: "[Subtask Title]"
+status: pending
+---
+
+## Description
+
+[Brief description]
+
+## Acceptance Criteria
+
+- [ ] Criterion 1
+`;
+    await fs.writeFile('.tasks/templates/epic-template.md', epicTemplate);
+    await fs.writeFile('.tasks/templates/subtask-template.md', subtaskTemplate);
+}
+async function updateGitignore() {
+    const gitignoreAdditions = `
+# archai - Agent scratch space (temporary files)
+.agents/scratch/*
+!.agents/scratch/.gitkeep
+.agents/thoughts/*
+!.agents/thoughts/.gitkeep
+.agents/plans/*
+!.agents/plans/.gitkeep
+
+# archai - Working state (cleared after tasks complete)
+.claude/state/*
+!.claude/state/.gitkeep
+!.claude/state/archived/
+`;
+    const gitignorePath = '.gitignore';
+    let content = '';
+    if (await fs.pathExists(gitignorePath)) {
+        content = await fs.readFile(gitignorePath, 'utf-8');
+        if (content.includes('# archai')) {
+            // Already has archai entries
+            return;
+        }
+    }
+    await fs.writeFile(gitignorePath, content + gitignoreAdditions);
+}
+//# sourceMappingURL=create-structure.js.map

package/dist/scaffold/create-structure.js.map

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

package/dist/types/dependency-analysis.d.ts

@@ -0,0 +1,11 @@
+import type { TaskSpec } from './task.js';
+/**
+ * A group of tasks that can execute together.
+ * If parallel is true, the tasks within this group are independent and can run concurrently.
+ * If parallel is false, the group contains a single task that must run alone.
+ */
+export interface ExecutionGroup {
+    tasks: TaskSpec[];
+    parallel: boolean;
+}
+//# sourceMappingURL=dependency-analysis.d.ts.map

package/dist/types/dependency-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-analysis.d.ts","sourceRoot":"","sources":["../../src/types/dependency-analysis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB"}

package/dist/types/dependency-analysis.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dependency-analysis.js.map

package/dist/types/dependency-analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-analysis.js","sourceRoot":"","sources":["../../src/types/dependency-analysis.ts"],"names":[],"mappings":""}