@fifine/aim-studio 0.0.1

package/dist/templates/markdown/workspace-index.md

@@ -0,0 +1,123 @@
+# Workspace Index
+
+> Records of all AI Agent work records across all developers
+
+---
+
+## Overview
+
+This directory tracks records for all developers working with AI Agents on this project.
+
+### File Structure
+
+```
+workspace/
+|-- index.md              # This file - main index
++-- {developer}/          # Per-developer directory
+    |-- index.md          # Personal index with session history
+    |-- tasks/         # Task files
+    |   |-- *.json        # Active tasks
+    |   +-- archive/      # Archived tasks by month
+    +-- journal-N.md     # Journal files (sequential: 1, 2, 3...)
+```
+
+---
+
+## Active Developers
+
+| Developer | Last Active | Sessions | Active File |
+|-----------|-------------|----------|-------------|
+| (none yet) | - | - | - |
+
+---
+
+## Getting Started
+
+### For New Developers
+
+Run the initialization script:
+
+```bash
+python3 ./.aim-studio/scripts/init_developer.py <your-name>
+```
+
+This will:
+1. Create your identity file (gitignored)
+2. Create your progress directory
+3. Create your personal index
+4. Create initial journal file
+
+### For Returning Developers
+
+1. Get your developer name:
+   ```bash
+   python3 ./.aim-studio/scripts/get_developer.py
+   ```
+
+2. Read your personal index:
+   ```bash
+   cat .aim-studio/workspace/$(python3 ./.aim-studio/scripts/get_developer.py)/index.md
+   ```
+
+---
+
+## Guidelines
+
+### Journal File Rules
+
+- **Max 2000 lines** per journal file
+- When limit is reached, create `journal-{N+1}.md`
+- Update your personal `index.md` when creating new files
+
+### Session Record Format
+
+Each session should include:
+- Summary: One-line description
+- Main Changes: What was modified
+- Git Commits: Commit hashes and messages
+- Next Steps: What to do next
+
+---
+
+## Session Template
+
+Use this template when recording sessions:
+
+```markdown
+## Session {N}: {Title}
+
+**Date**: YYYY-MM-DD
+**Task**: {task-name}
+
+### Summary
+
+{One-line summary}
+
+### Main Changes
+
+- {Change 1}
+- {Change 2}
+
+### Git Commits
+
+| Hash | Message |
+|------|---------|
+| `abc1234` | {commit message} |
+
+### Testing
+
+- [OK] {Test result}
+
+### Status
+
+[OK] **Completed** / # **In Progress** / [P] **Blocked**
+
+### Next Steps
+
+- {Next step 1}
+- {Next step 2}
+```
+
+---
+
+**Language**: All documentation must be written in **English**.

package/dist/templates/markdown/worktree.yaml.txt

@@ -0,0 +1,58 @@
+# Worktree Configuration for Multi-Agent Pipeline
+# Used for worktree initialization in multi-agent workflows
+#
+# All paths are relative to project root
+
+#-------------------------------------------------------------------------------
+# Paths
+#-------------------------------------------------------------------------------
+
+# Worktree storage directory (relative to project root)
+# Recommended: keep worktrees outside the main repo to avoid conflicts
+worktree_dir: ../<project-name>-worktrees
+
+#-------------------------------------------------------------------------------
+# Files to Copy
+#-------------------------------------------------------------------------------
+
+# Files to copy to each worktree (each worktree needs independent copy)
+# These files contain sensitive info or need worktree-independent config
+copy:
+  # Environment variables (uncomment and customize as needed)
+  # - .env
+  # - .env.local
+  # Workflow config
+  - .aim-studio/.developer
+
+#-------------------------------------------------------------------------------
+# Post-Create Hooks
+#-------------------------------------------------------------------------------
+
+# Commands to run after creating worktree
+# Executed in worktree directory, in order, abort on failure
+post_create:
+  # Install dependencies (uncomment based on your package manager)
+  # - npm install
+  # - pnpm install --frozen-lockfile
+  # - yarn install --frozen-lockfile
+  # - pip install -r requirements.txt
+  # - bundle install
+  # - cargo build
+
+#-------------------------------------------------------------------------------
+# Pre-Merge Checks
+#-------------------------------------------------------------------------------
+
+# Pre-merge validation (used by create_pr.py)
+pre_merge:
+  # Type checking (uncomment based on your setup)
+  # - npm run typecheck
+  # - pnpm typecheck
+  # - mypy .
+  # Linting
+  # - npm run lint
+  # - pnpm lint
+  # - ruff check .
+  # Testing
+  # - npm test
+  # - pytest

package/dist/templates/trellis/gitignore.txt

@@ -0,0 +1,29 @@
+# Developer identity (local only)
+.developer
+
+# Current task pointer (each dev works on different task)
+.current-task
+
+# Ralph Loop state file
+.ralph-state.json
+
+# Agent runtime files
+.agents/
+.agent-log
+.session-id
+
+# Task directory runtime files
+.plan-log
+
+# Atomic update temp files
+*.tmp
+
+# Update backup directories
+.backup-*
+
+# Conflict resolution temp files
+*.new
+
+# Python cache
+**/__pycache__/
+**/*.pyc

package/dist/templates/trellis/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Trellis workflow templates
+ *
+ * These are GENERIC templates for user projects.
+ * Do NOT use Trellis project's own .trellis/ directory (which may be customized).
+ *
+ * Directory structure:
+ *   trellis/
+ *   ├── scripts/
+ *   │   ├── __init__.py
+ *   │   ├── common/           # Shared utilities (Python)
+ *   │   ├── multi_agent/      # Multi-agent pipeline scripts (Python)
+ *   │   └── *.py              # Main scripts (Python)
+ *   ├── scripts-shell-archive/ # Archived shell scripts (for reference)
+ *   ├── workflow.md           # Workflow guide
+ *   ├── worktree.yaml         # Worktree configuration
+ *   └── gitignore.txt         # .gitignore content
+ */
+export declare const scriptsInit: string;
+export declare const commonInit: string;
+export declare const commonPaths: string;
+export declare const commonDeveloper: string;
+export declare const commonGitContext: string;
+export declare const commonWorktree: string;
+export declare const commonTaskQueue: string;
+export declare const commonTaskUtils: string;
+export declare const commonPhase: string;
+export declare const commonRegistry: string;
+export declare const commonCliAdapter: string;
+export declare const multiAgentInit: string;
+export declare const multiAgentStart: string;
+export declare const multiAgentCleanup: string;
+export declare const multiAgentStatus: string;
+export declare const multiAgentCreatePr: string;
+export declare const multiAgentPlan: string;
+export declare const getDeveloperScript: string;
+export declare const initDeveloperScript: string;
+export declare const taskScript: string;
+export declare const getContextScript: string;
+export declare const addSessionScript: string;
+export declare const createBootstrapScript: string;
+export declare const workflowMdTemplate: string;
+export declare const worktreeYamlTemplate: string;
+export declare const gitignoreTemplate: string;
+/**
+ * Get all script templates as a map of relative path to content
+ */
+export declare function getAllScripts(): Map<string, string>;
+//# sourceMappingURL=index.d.ts.map

package/dist/templates/trellis/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/trellis/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAcH,eAAO,MAAM,WAAW,QAAsC,CAAC;AAG/D,eAAO,MAAM,UAAU,QAA6C,CAAC;AACrE,eAAO,MAAM,WAAW,QAA0C,CAAC;AACnE,eAAO,MAAM,eAAe,QAA8C,CAAC;AAC3E,eAAO,MAAM,gBAAgB,QAAgD,CAAC;AAC9E,eAAO,MAAM,cAAc,QAA6C,CAAC;AACzE,eAAO,MAAM,eAAe,QAA+C,CAAC;AAC5E,eAAO,MAAM,eAAe,QAA+C,CAAC;AAC5E,eAAO,MAAM,WAAW,QAA0C,CAAC;AACnE,eAAO,MAAM,cAAc,QAA6C,CAAC;AACzE,eAAO,MAAM,gBAAgB,QAAgD,CAAC;AAG9E,eAAO,MAAM,cAAc,QAAkD,CAAC;AAC9E,eAAO,MAAM,eAAe,QAA+C,CAAC;AAC5E,eAAO,MAAM,iBAAiB,QAAiD,CAAC;AAChF,eAAO,MAAM,gBAAgB,QAAgD,CAAC;AAC9E,eAAO,MAAM,kBAAkB,QAAmD,CAAC;AACnF,eAAO,MAAM,cAAc,QAA8C,CAAC;AAG1E,eAAO,MAAM,kBAAkB,QAA2C,CAAC;AAC3E,eAAO,MAAM,mBAAmB,QAA4C,CAAC;AAC7E,eAAO,MAAM,UAAU,QAAkC,CAAC;AAC1D,eAAO,MAAM,gBAAgB,QAAyC,CAAC;AACvE,eAAO,MAAM,gBAAgB,QAAyC,CAAC;AACvE,eAAO,MAAM,qBAAqB,QAA8C,CAAC;AAGjF,eAAO,MAAM,kBAAkB,QAA8B,CAAC;AAC9D,eAAO,MAAM,oBAAoB,QAAgC,CAAC;AAClE,eAAO,MAAM,iBAAiB,QAAgC,CAAC;AAE/D;;GAEG;AACH,wBAAgB,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAmCnD"}

package/dist/templates/trellis/index.js

@@ -0,0 +1,92 @@
+/**
+ * Trellis workflow templates
+ *
+ * These are GENERIC templates for user projects.
+ * Do NOT use Trellis project's own .trellis/ directory (which may be customized).
+ *
+ * Directory structure:
+ *   trellis/
+ *   ├── scripts/
+ *   │   ├── __init__.py
+ *   │   ├── common/           # Shared utilities (Python)
+ *   │   ├── multi_agent/      # Multi-agent pipeline scripts (Python)
+ *   │   └── *.py              # Main scripts (Python)
+ *   ├── scripts-shell-archive/ # Archived shell scripts (for reference)
+ *   ├── workflow.md           # Workflow guide
+ *   ├── worktree.yaml         # Worktree configuration
+ *   └── gitignore.txt         # .gitignore content
+ */
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+function readTemplate(relativePath) {
+    return readFileSync(join(__dirname, relativePath), "utf-8");
+}
+// Python scripts - package init
+export const scriptsInit = readTemplate("scripts/__init__.py");
+// Python scripts - common
+export const commonInit = readTemplate("scripts/common/__init__.py");
+export const commonPaths = readTemplate("scripts/common/paths.py");
+export const commonDeveloper = readTemplate("scripts/common/developer.py");
+export const commonGitContext = readTemplate("scripts/common/git_context.py");
+export const commonWorktree = readTemplate("scripts/common/worktree.py");
+export const commonTaskQueue = readTemplate("scripts/common/task_queue.py");
+export const commonTaskUtils = readTemplate("scripts/common/task_utils.py");
+export const commonPhase = readTemplate("scripts/common/phase.py");
+export const commonRegistry = readTemplate("scripts/common/registry.py");
+export const commonCliAdapter = readTemplate("scripts/common/cli_adapter.py");
+// Python scripts - multi_agent
+export const multiAgentInit = readTemplate("scripts/multi_agent/__init__.py");
+export const multiAgentStart = readTemplate("scripts/multi_agent/start.py");
+export const multiAgentCleanup = readTemplate("scripts/multi_agent/cleanup.py");
+export const multiAgentStatus = readTemplate("scripts/multi_agent/status.py");
+export const multiAgentCreatePr = readTemplate("scripts/multi_agent/create_pr.py");
+export const multiAgentPlan = readTemplate("scripts/multi_agent/plan.py");
+// Python scripts - main
+export const getDeveloperScript = readTemplate("scripts/get_developer.py");
+export const initDeveloperScript = readTemplate("scripts/init_developer.py");
+export const taskScript = readTemplate("scripts/task.py");
+export const getContextScript = readTemplate("scripts/get_context.py");
+export const addSessionScript = readTemplate("scripts/add_session.py");
+export const createBootstrapScript = readTemplate("scripts/create_bootstrap.py");
+// Configuration files
+export const workflowMdTemplate = readTemplate("workflow.md");
+export const worktreeYamlTemplate = readTemplate("worktree.yaml");
+export const gitignoreTemplate = readTemplate("gitignore.txt");
+/**
+ * Get all script templates as a map of relative path to content
+ */
+export function getAllScripts() {
+    const scripts = new Map();
+    // Package init
+    scripts.set("__init__.py", scriptsInit);
+    // Common
+    scripts.set("common/__init__.py", commonInit);
+    scripts.set("common/paths.py", commonPaths);
+    scripts.set("common/developer.py", commonDeveloper);
+    scripts.set("common/git_context.py", commonGitContext);
+    scripts.set("common/worktree.py", commonWorktree);
+    scripts.set("common/task_queue.py", commonTaskQueue);
+    scripts.set("common/task_utils.py", commonTaskUtils);
+    scripts.set("common/phase.py", commonPhase);
+    scripts.set("common/registry.py", commonRegistry);
+    scripts.set("common/cli_adapter.py", commonCliAdapter);
+    // Multi-agent
+    scripts.set("multi_agent/__init__.py", multiAgentInit);
+    scripts.set("multi_agent/start.py", multiAgentStart);
+    scripts.set("multi_agent/cleanup.py", multiAgentCleanup);
+    scripts.set("multi_agent/status.py", multiAgentStatus);
+    scripts.set("multi_agent/create_pr.py", multiAgentCreatePr);
+    scripts.set("multi_agent/plan.py", multiAgentPlan);
+    // Main
+    scripts.set("get_developer.py", getDeveloperScript);
+    scripts.set("init_developer.py", initDeveloperScript);
+    scripts.set("task.py", taskScript);
+    scripts.set("get_context.py", getContextScript);
+    scripts.set("add_session.py", addSessionScript);
+    scripts.set("create_bootstrap.py", createBootstrapScript);
+    return scripts;
+}
+//# sourceMappingURL=index.js.map

package/dist/templates/trellis/index.js.map

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

package/dist/templates/trellis/scripts/__init__.py

@@ -0,0 +1,5 @@
+"""
+Trellis Python Scripts
+
+This module provides Python implementations of Trellis workflow scripts.
+"""