rbin-task-flow 1.5.0 → 1.6.0

package/AGENTS.md

@@ -0,0 +1,42 @@
+# Project norms (Codex)
+
+This repo follows the same development norms as in `.cursor/rules/` and `CLAUDE.md`. When working here, follow these rules.
+
+## Git
+
+- **Never run** `git add`, `git commit`, `git push`, `git pull`, `git merge`, `git checkout`, `git reset`, `git rebase`, etc.
+- **Only suggest** git commands; the user runs them.
+- You **may** run read-only git: `git status`, `git diff`, `git log`, `git show`, `git branch` (list only).
+
+## Commits
+
+- After completing tasks, **suggest** a commit message (Conventional Commits: `feat`, `fix`, `refactor`, `docs`, `test`, `chore`).
+- Include task/subtask ID when relevant, e.g. `Task ID: 3.2`.
+
+## Code and comments
+
+- **No explanatory comments** in code; keep code self-explanatory via names.
+- **Document non-obvious or complex topics** in `dev-logs/` (markdown).
+- **Allowed comments**: only section separators in this form:
+  ```text
+  // ────────────────────────────────
+  // Section Name
+  // ────────────────────────────────
+  ```
+
+## RBIN Task Flow
+
+- **Task flow** always means **RBIN Task Flow**.
+- Tasks: `.task-flow/tasks.input.txt` (format: `- Task description`).
+- Status: `.task-flow/tasks.status.md` and `.task-flow/.internal/status.json`.
+- **Commands** to support: `task-flow: sync`, `task-flow: think`, `task-flow: audit`, `task-flow: status`, `task-flow: run next X`, `task-flow: run X` (or `X,Y` / `all`), `task-flow: review X`, `task-flow: refactor X`, `task-flow: estimate X`, `task-flow: report X`.
+- When running `task-flow: audit`: scan the codebase, score it against `.cursor/rules/coding_standards.mdc`, present a report, and ask the user which improvements to adopt — never impose changes.
+- When running subtasks: read `.task-flow/.internal/tasks.json` and `status.json`, implement, then update `status.json` and `tasks.status.md` (mark done, refresh summary).
+- Use context from `.task-flow/contexts/` when subtask instructions reference it.
+
+## Full rules
+
+For complete wording and examples, see:
+
+- `CLAUDE.md` – overview and task-flow commands
+- `.cursor/rules/` – all rules (git, commits, comments, task-flow, etc.)

package/lib/install.js

@@ -48,7 +48,7 @@ async function installInProject(targetPath, options = {}) {
 
     spinner.text = 'Copying configuration files...';
 
-    await copyConfigs(targetPath);
+    await copyConfigs(targetPath, isUpdate);
 
     spinner.text = 'Updating .gitignore...';
 
@@ -69,14 +69,14 @@ async function installInProject(targetPath, options = {}) {
   }
 }
 
-async function copyConfigs(targetPath) {
+async function copyConfigs(targetPath, isUpdate = false) {
   const cursorRulesPath = path.join(TEMPLATE_DIR, '.cursor/rules');
+  const cursorRulesDest = path.join(targetPath, '.cursor/rules');
   if (fs.existsSync(cursorRulesPath)) {
-    await fs.copy(
-      cursorRulesPath,
-      path.join(targetPath, '.cursor/rules'),
-      { overwrite: true }
-    );
+    if (isUpdate && fs.existsSync(cursorRulesDest)) {
+      await fs.emptyDir(cursorRulesDest);
+    }
+    await fs.copy(cursorRulesPath, cursorRulesDest, { overwrite: true });
     showSuccess('Cursor rules');
   }
 
@@ -110,6 +110,16 @@ async function copyConfigs(targetPath) {
     showSuccess('Claude instructions');
   }
 
+  const agentsPath = path.join(TEMPLATE_DIR, 'AGENTS.md');
+  if (fs.existsSync(agentsPath)) {
+    await fs.copy(
+      agentsPath,
+      path.join(targetPath, 'AGENTS.md'),
+      { overwrite: true }
+    );
+    showSuccess('Codex instructions (AGENTS.md)');
+  }
+
   await copyTaskFlow(targetPath);
 }
 
@@ -119,39 +129,22 @@ async function copyTaskFlow(targetPath) {
 
   await fs.ensureDir(taskFlowDest);
 
-  showSuccess('Task Flow directory');
-  showInfo('Note: .internal/tasks.json and .internal/status.json are NOT overwritten (your data is safe)');
-
-  const contextsDest = path.join(taskFlowDest, 'contexts');
-  await fs.ensureDir(contextsDest);
-  showSuccess('Contexts directory (.task-flow/contexts/)');
-
-  const docsDest = path.join(taskFlowDest, 'docs');
-  await fs.ensureDir(docsDest);
-  showSuccess('Documentation directory (.task-flow/docs/)');
-
-  const exampleSrc = path.join(taskFlowSrc, 'contexts/example.png.txt');
-  const exampleDest = path.join(contextsDest, 'example.png.txt');
-  if (fs.existsSync(exampleSrc) && !fs.existsSync(exampleDest)) {
-    await fs.copy(exampleSrc, exampleDest);
-  }
-
-  const files = [
-    { name: 'README.md', overwrite: true },
-    { name: 'tasks.input.txt', overwrite: false },
-    { name: 'tasks.status.md', overwrite: false }
+  const PROTECTED = [
+    path.join(taskFlowDest, '.internal'),
   ];
 
-  for (const file of files) {
-    const src = path.join(taskFlowSrc, file.name);
-    const dest = path.join(taskFlowDest, file.name);
+  await fs.copy(taskFlowSrc, taskFlowDest, {
+    overwrite: true,
+    filter: (src) => {
+      return !PROTECTED.some((p) => src.startsWith(p));
+    },
+  });
 
-    if (fs.existsSync(src)) {
-      if (file.overwrite || !fs.existsSync(dest)) {
-        await fs.copy(src, dest, { overwrite: file.overwrite });
-      }
-    }
-  }
+  await fs.ensureDir(path.join(taskFlowDest, 'contexts'));
+  await fs.ensureDir(path.join(taskFlowDest, 'docs'));
+
+  showSuccess('Task Flow directory (overwritten)');
+  showInfo('Protected: .internal/ (your task data is safe)');
 }
 
 async function updateGitignore(targetPath) {
@@ -167,7 +160,8 @@ async function updateGitignore(targetPath) {
     '.claude/',
     '.cursor/',
     '.task-flow/',
-    'CLAUDE.md'
+    'CLAUDE.md',
+    'AGENTS.md'
   ];
 
   for (const entry of entries) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rbin-task-flow",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "AI-powered task management for Claude and Cursor",
   "main": "index.js",
   "bin": {
@@ -33,6 +33,7 @@
     ".task-flow/",
     ".model-versions.json",
     "CLAUDE.md",
+    "AGENTS.md",
     "lib/"
   ],
   "preferGlobal": true,