@trycedar/argus 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 0.2.0 - 2026-05-13
+
+**Breaking changes** — codename Argus is now the system identity, not just the npm scope. Existing 0.1.x workspaces auto-migrate.
+
+### Breaking
+
+- CLI binary renamed: `proactive` → `argus`. Update your install command (`npm i -g @trycedar/argus`) and any scripts that call `proactive`.
+- Workspace state directory renamed: `.proactive/` → `.argus/`. The CLI auto-migrates on first run when only the legacy directory exists; manual rename is otherwise safe.
+- Environment variables renamed: `PROACTIVE_CODEX_COMMAND` → `ARGUS_CODEX_COMMAND`, `PROACTIVE_CODEX_TIMEOUT_MS` → `ARGUS_CODEX_TIMEOUT_MS`. The legacy names continue to work for one release with a deprecation warning, then will be removed in 0.3.0.
+
+### Fixed (rolled in from unreleased 0.1.1)
+
+- `argus approve` / `argus reject` now update the matched inbox file in place instead of creating a duplicate `<id>.md` file when the source filename has a descriptive suffix. (task-018)
+- Repeat approvals no longer stack `## CEO Response` sections; the latest response replaces any prior one.
+
+### Added
+
+- Migration helper `migrateLegacyWorkspaceDir()` runs as a Commander `preAction` hook on every invocation. Idempotent and side-effect-free when no legacy directory is present.
+- Codex provider temp-dir prefix renamed `proactive-codex-` → `argus-codex-`.
+
 ## 0.1.0 - 2026-05-13
 
 Initial dogfood release candidate. Published as `@trycedar/argus` (codename Argus). The CLI binary is `proactive` in this release and will be renamed to `argus` in 0.2.0.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jacob Wang and Argus contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,6 +1,12 @@
-# Proactive AI
+# Argus
 
-> A Git-native agentic organization framework where a human CEO directs proactive role agents that create tasks, produce artifacts, request approvals, and help build software products.
+[![npm version](https://img.shields.io/npm/v/@trycedar/argus.svg)](https://www.npmjs.com/package/@trycedar/argus)
+[![CI](https://github.com/xiangkangjw/argus/actions/workflows/validate.yml/badge.svg)](https://github.com/xiangkangjw/argus/actions/workflows/validate.yml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
+[![Node](https://img.shields.io/node/v/@trycedar/argus.svg)](https://nodejs.org)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6?logo=typescript&logoColor=white)](./tsconfig.json)
+
+> A Git-native agentic organization framework where a human CEO directs proactive role agents that create tasks, produce artifacts, request approvals, and help build software products. Codename: Argus.
 
 ## Vision
 
@@ -16,7 +22,7 @@ Proactive AI is not multi-agent chat. It is a local-first company workspace wher
 
 ## Current status
 
-This repository has an initial v0 CLI/runtime foundation and dogfoods Proactive AI against itself. `0.1.0` is a local-first release candidate; publishing still requires explicit human approval.
+`@trycedar/argus@0.2.0` — dogfood release. The CLI binary is `argus`. Workspaces from 0.1.x auto-migrate on first run.
 
 Key docs:
 
@@ -32,7 +38,7 @@ Key docs:
 This repo includes the initial Proactive AI workspace structure:
 
 ```text
-.proactive/
+.argus/
 company/
 tasks/
 artifacts/
@@ -65,14 +71,14 @@ From source:
 pnpm install
 pnpm build
 pnpm link --global
-proactive --help
+argus --help
 ```
 
 After npm publication:
 
 ```bash
 npm install -g @trycedar/argus
-proactive --help
+argus --help
 ```
 
 ## CLI
@@ -92,7 +98,7 @@ pnpm exec tsx src/cli/index.ts reject <item-id> --response "Rejected"
 pnpm exec tsx src/cli/index.ts agents
 ```
 
-`proactive run --no-ai` scans the workspace and plans agent wakeups without invoking Codex. `proactive run --provider stub` performs a controlled dogfood run with deterministic stubbed agent output. Running without `--no-ai` uses the default `CodexProvider`, which shells out to `codex exec`; set `PROACTIVE_CODEX_COMMAND` if the executable name differs.
+`argus run --no-ai` scans the workspace and plans agent wakeups without invoking Codex. `argus run --provider stub` performs a controlled dogfood run with deterministic stubbed agent output. Running without `--no-ai` uses the default `CodexProvider`, which shells out to `codex exec`; set `ARGUS_CODEX_COMMAND` if the executable name differs.
 
 ## Property-management demo
 

package/dist/index.js

@@ -7,7 +7,7 @@ import { mkdir as mkdir6, readFile as readFile9, writeFile as writeFile7 } from
 
 // src/workspace/init.ts
 import { mkdir as mkdir2, writeFile as writeFile3 } from "fs/promises";
-import path3 from "path";
+import path4 from "path";
 import YAML from "yaml";
 
 // src/markdown/frontmatter.ts
@@ -129,7 +129,48 @@ async function readEvents(workspaceRoot) {
 
 // src/workspace/state.ts
 import { readFile as readFile2, writeFile as writeFile2 } from "fs/promises";
+import path3 from "path";
+
+// src/workspace/paths.ts
+import { rename } from "fs/promises";
 import path2 from "path";
+var WORKSPACE_DIR = ".argus";
+var LEGACY_WORKSPACE_DIR = ".proactive";
+async function migrateLegacyWorkspaceDir(workspaceRoot) {
+  const fs = await import("fs/promises");
+  const legacy = path2.join(workspaceRoot, LEGACY_WORKSPACE_DIR);
+  const target = path2.join(workspaceRoot, WORKSPACE_DIR);
+  const [legacyExists, targetExists] = await Promise.all([
+    fs.stat(legacy).then(
+      () => true,
+      () => false
+    ),
+    fs.stat(target).then(
+      () => true,
+      () => false
+    )
+  ]);
+  if (!legacyExists || targetExists) return false;
+  await rename(legacy, target);
+  console.warn(
+    `[argus] migrated legacy workspace directory ${LEGACY_WORKSPACE_DIR}/ -> ${WORKSPACE_DIR}/`
+  );
+  return true;
+}
+var taskStatusToDirectory = {
+  backlog: "backlog",
+  ready: "ready",
+  in_progress: "in-progress",
+  review: "review",
+  done: "done",
+  blocked: "blocked",
+  cancelled: "cancelled"
+};
+function resolveWorkspace(root = process.cwd()) {
+  return path2.resolve(root);
+}
+
+// src/workspace/state.ts
 function initialState() {
   return {
     last_event_id: "evt-001",
@@ -139,7 +180,7 @@ function initialState() {
   };
 }
 async function readState(workspaceRoot) {
-  const statePath = path2.join(workspaceRoot, ".proactive", "state.json");
+  const statePath = path3.join(workspaceRoot, WORKSPACE_DIR, "state.json");
   try {
     return workspaceStateSchema.parse(
       JSON.parse(await readFile2(statePath, "utf8"))
@@ -151,7 +192,7 @@ async function readState(workspaceRoot) {
   }
 }
 async function writeState(workspaceRoot, state) {
-  const statePath = path2.join(workspaceRoot, ".proactive", "state.json");
+  const statePath = path3.join(workspaceRoot, WORKSPACE_DIR, "state.json");
   await writeFile2(
     statePath,
     `${JSON.stringify(workspaceStateSchema.parse(state), null, 2)}
@@ -272,7 +313,7 @@ var decisionsTemplate = `# Decisions
 
 // src/workspace/init.ts
 var directories = [
-  ".proactive",
+  WORKSPACE_DIR,
   "company",
   "tasks/backlog",
   "tasks/ready",
@@ -292,10 +333,10 @@ var directories = [
 ];
 async function initializeWorkspace(workspaceRoot, workspaceName) {
   for (const directory of directories) {
-    await mkdir2(path3.join(workspaceRoot, directory), { recursive: true });
+    await mkdir2(path4.join(workspaceRoot, directory), { recursive: true });
   }
   await writeFile3(
-    path3.join(workspaceRoot, ".proactive", "config.yaml"),
+    path4.join(workspaceRoot, WORKSPACE_DIR, "config.yaml"),
     YAML.stringify({
       workspace_name: workspaceName,
       schema_version: 0,
@@ -306,20 +347,20 @@ async function initializeWorkspace(workspaceRoot, workspaceName) {
   );
   await writeState(workspaceRoot, initialState());
   await writeFile3(
-    path3.join(workspaceRoot, "company", "mission.md"),
+    path4.join(workspaceRoot, "company", "mission.md"),
     missionTemplate(workspaceName)
   );
   await writeFile3(
-    path3.join(workspaceRoot, "company", "strategy.md"),
+    path4.join(workspaceRoot, "company", "strategy.md"),
     strategyTemplate
   );
   await writeFile3(
-    path3.join(workspaceRoot, "company", "decisions.md"),
+    path4.join(workspaceRoot, "company", "decisions.md"),
     decisionsTemplate
   );
   for (const agent of defaultAgents) {
     await writeFile3(
-      path3.join(workspaceRoot, "agents", agent.filename),
+      path4.join(workspaceRoot, "agents", agent.filename),
       stringifyMarkdown(agent.data, agent.body)
     );
   }
@@ -333,23 +374,8 @@ async function initializeWorkspace(workspaceRoot, workspaceName) {
   await appendEvent(workspaceRoot, event);
 }
 
-// src/workspace/paths.ts
-import path4 from "path";
-var taskStatusToDirectory = {
-  backlog: "backlog",
-  ready: "ready",
-  in_progress: "in-progress",
-  review: "review",
-  done: "done",
-  blocked: "blocked",
-  cancelled: "cancelled"
-};
-function resolveWorkspace(root = process.cwd()) {
-  return path4.resolve(root);
-}
-
 // src/tasks/task-store.ts
-import { mkdir as mkdir3, readFile as readFile3, rename, writeFile as writeFile4 } from "fs/promises";
+import { mkdir as mkdir3, readFile as readFile3, rename as rename2, writeFile as writeFile4 } from "fs/promises";
 import path5 from "path";
 import fg from "fast-glob";
 function taskFilename(task) {
@@ -421,16 +447,21 @@ async function writeInboxItem(workspaceRoot, item, content) {
   return relativePath;
 }
 async function respondToInboxItem(workspaceRoot, doc, status, response) {
-  await writeInboxItem(
-    workspaceRoot,
-    { ...doc.item, status, updated_at: (/* @__PURE__ */ new Date()).toISOString() },
-    `${doc.content.trimEnd()}
+  const updatedItem = inboxItemSchema.parse({
+    ...doc.item,
+    status,
+    updated_at: (/* @__PURE__ */ new Date()).toISOString()
+  });
+  const baseContent = doc.content.replace(/\n*##\s+CEO Response[\s\S]*$/m, "");
+  const nextContent = `${baseContent.trimEnd()}
 
 ## CEO Response
 
 ${response}
-`
-  );
+`;
+  const absolutePath = path6.join(workspaceRoot, doc.path);
+  await mkdir4(path6.dirname(absolutePath), { recursive: true });
+  await writeFile5(absolutePath, stringifyMarkdown(updatedItem, nextContent));
 }
 
 // src/agents/agent-store.ts
@@ -916,13 +947,32 @@ import { mkdtemp, readFile as readFile8, rm } from "fs/promises";
 import os from "os";
 import path11 from "path";
 import { execa } from "execa";
+function resolveCodexCommand() {
+  if (process.env.ARGUS_CODEX_COMMAND) return process.env.ARGUS_CODEX_COMMAND;
+  if (process.env.PROACTIVE_CODEX_COMMAND) {
+    console.warn(
+      "[argus] PROACTIVE_CODEX_COMMAND is deprecated; use ARGUS_CODEX_COMMAND."
+    );
+    return process.env.PROACTIVE_CODEX_COMMAND;
+  }
+  return "codex";
+}
+function resolveCodexTimeoutMs() {
+  const raw = process.env.ARGUS_CODEX_TIMEOUT_MS ?? process.env.PROACTIVE_CODEX_TIMEOUT_MS;
+  if (process.env.PROACTIVE_CODEX_TIMEOUT_MS && !process.env.ARGUS_CODEX_TIMEOUT_MS) {
+    console.warn(
+      "[argus] PROACTIVE_CODEX_TIMEOUT_MS is deprecated; use ARGUS_CODEX_TIMEOUT_MS."
+    );
+  }
+  return Number.parseInt(raw ?? "120000", 10);
+}
 var CodexProvider = class {
-  constructor(command = process.env.PROACTIVE_CODEX_COMMAND ?? "codex") {
+  constructor(command = resolveCodexCommand()) {
     this.command = command;
   }
   command;
   async complete(request) {
-    const tempDir = await mkdtemp(path11.join(os.tmpdir(), "proactive-codex-"));
+    const tempDir = await mkdtemp(path11.join(os.tmpdir(), "argus-codex-"));
     const outputPath = path11.join(tempDir, "last-message.txt");
     try {
       const result = await execa(
@@ -943,10 +993,7 @@ Do not inspect files or run commands. Return only the JSON object requested abov
           reject: false,
           env: process.env,
           stdin: "ignore",
-          timeout: Number.parseInt(
-            process.env.PROACTIVE_CODEX_TIMEOUT_MS ?? "120000",
-            10
-          )
+          timeout: resolveCodexTimeoutMs()
         }
       );
       if (result.exitCode !== 0) {
@@ -1044,11 +1091,22 @@ function propertyManagementActions(agentId) {
 
 // src/cli/index.ts
 var program = new Command();
-program.name("proactive").description("Git-native proactive AI workspace CLI").version("0.1.0");
+program.name("argus").description(
+  "Argus \u2014 Git-native proactive AI agent organization framework CLI"
+).version("0.2.0").hook("preAction", async () => {
+  try {
+    await migrateLegacyWorkspaceDir(process.cwd());
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(
+      `Failed to migrate legacy .proactive/ workspace to .argus/: ${message}. Resolve the underlying issue (permissions, cross-device, busy file) then re-run. To migrate manually: \`mv .proactive .argus\`.`
+    );
+  }
+});
 program.command("init").argument("<workspace-name>").option("--root <path>", "workspace root; defaults to ./<workspace-name>").action(async (workspaceName, options) => {
   const root = path12.resolve(options.root ?? workspaceName);
   await initializeWorkspace(root, workspaceName);
-  console.log(`Initialized Proactive AI workspace at ${root}`);
+  console.log(`Initialized Argus workspace at ${root}`);
 });
 program.command("ceo").argument("<instruction>").action(async (instruction) => {
   const root = resolveWorkspace();

package/package.json

@@ -1,16 +1,18 @@
 {
   "name": "@trycedar/argus",
-  "version": "0.1.0",
-  "description": "Git-native proactive AI agent organization framework CLI.",
+  "license": "MIT",
+  "version": "0.2.0",
+  "description": "Argus — Git-native proactive AI agent organization framework CLI.",
   "type": "module",
   "packageManager": "pnpm@10.25.0",
   "bin": {
-    "proactive": "dist/index.js"
+    "argus": "dist/index.js"
   },
   "files": [
     "dist",
     "README.md",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "LICENSE"
   ],
   "publishConfig": {
     "access": "public"