@agentprojectcontext/apx 1.56.2 → 1.58.0

package/src/host/daemon/api/files-project.js

@@ -0,0 +1,99 @@
+// Project file browser + docs editor API.
+//
+// A sandboxed view of one project's own files. `scope` selects the sandbox:
+//   project — the whole repo (the /files browser)
+//   docs     — the docs subfolder (config docs.root, default "docs"); powers
+//              the /docs spec editor
+//
+//   GET    /projects/:pid/fs/tree?scope=project|docs
+//   GET    /projects/:pid/fs/file?scope=…&path=<rel>
+//   PUT    /projects/:pid/fs/file        body { scope?, path, content }
+//   POST   /projects/:pid/fs/dir         body { scope?, path }
+//   DELETE /projects/:pid/fs/entry?scope=…&path=<rel>
+//
+// Thin adapter over core/stores/project-files.
+import {
+  listTree,
+  readFile,
+  writeFile,
+  makeDir,
+  removeEntry,
+  docsSubdir,
+} from "#core/stores/project-files.js";
+
+// Resolve the sandbox subdir for a scope. Unknown scope → project root.
+function scopeOpts(p, scope) {
+  if (scope === "docs") return { subdir: docsSubdir(p.config), scope: "docs" };
+  return { subdir: "", scope: "project" };
+}
+
+export function register(app, { project }) {
+  app.get("/projects/:pid/fs/tree", (req, res) => {
+    const p = project(req, res);
+    if (!p) return;
+    const { subdir, scope } = scopeOpts(p, req.query?.scope);
+    try {
+      res.json({ scope, ...listTree(p.path, { subdir }) });
+    } catch (e) {
+      res.status(400).json({ error: e.message });
+    }
+  });
+
+  app.get("/projects/:pid/fs/file", (req, res) => {
+    const p = project(req, res);
+    if (!p) return;
+    const rel = req.query?.path;
+    if (!rel) return res.status(400).json({ error: "path required" });
+    const { subdir } = scopeOpts(p, req.query?.scope);
+    try {
+      const file = readFile(p.path, String(rel), { subdir });
+      if (!file) return res.status(404).json({ error: "file not found" });
+      res.json(file);
+    } catch (e) {
+      res.status(400).json({ error: e.message });
+    }
+  });
+
+  app.put("/projects/:pid/fs/file", (req, res) => {
+    const p = project(req, res);
+    if (!p) return;
+    const { path: rel, content, scope } = req.body || {};
+    if (!rel) return res.status(400).json({ error: "path required" });
+    if (typeof content !== "string")
+      return res.status(400).json({ error: "content must be a string" });
+    const { subdir } = scopeOpts(p, scope);
+    try {
+      res.json(writeFile(p.path, String(rel), content, { subdir }));
+    } catch (e) {
+      res.status(400).json({ error: e.message });
+    }
+  });
+
+  app.post("/projects/:pid/fs/dir", (req, res) => {
+    const p = project(req, res);
+    if (!p) return;
+    const { path: rel, scope } = req.body || {};
+    if (!rel) return res.status(400).json({ error: "path required" });
+    const { subdir } = scopeOpts(p, scope);
+    try {
+      res.status(201).json(makeDir(p.path, String(rel), { subdir }));
+    } catch (e) {
+      res.status(400).json({ error: e.message });
+    }
+  });
+
+  app.delete("/projects/:pid/fs/entry", (req, res) => {
+    const p = project(req, res);
+    if (!p) return;
+    const rel = req.query?.path;
+    if (!rel) return res.status(400).json({ error: "path required" });
+    const { subdir } = scopeOpts(p, req.query?.scope);
+    try {
+      if (!removeEntry(p.path, String(rel), { subdir }))
+        return res.status(404).json({ error: "entry not found" });
+      res.json({ ok: true });
+    } catch (e) {
+      res.status(400).json({ error: e.message });
+    }
+  });
+}

package/src/host/daemon/api/organization.js

@@ -0,0 +1,88 @@
+// Organization structure (areas + roles) per project.
+//
+//   GET    /projects/:pid/organization                 -> { areas, roles }
+//   POST   /projects/:pid/organization/areas           body { name, slug?, goal? }
+//   PATCH  /projects/:pid/organization/areas/:slug      body { name?, goal? }
+//   DELETE /projects/:pid/organization/areas/:slug      -> { ok }
+//   POST   /projects/:pid/organization/roles           body { name, slug?, area?, description? }
+//   PATCH  /projects/:pid/organization/roles/:slug      body { name?, area?, description? }
+//   DELETE /projects/:pid/organization/roles/:slug      -> { ok }
+//
+// Thin adapter: parse body, call core/stores/organization, shape the response.
+import {
+  readOrganization,
+  createArea,
+  updateArea,
+  removeArea,
+  createRole,
+  updateRole,
+  removeRole,
+} from "#core/stores/organization.js";
+
+export function register(app, { project }) {
+  app.get("/projects/:pid/organization", (req, res) => {
+    const p = project(req, res);
+    if (!p) return;
+    res.json(readOrganization(p.path));
+  });
+
+  app.post("/projects/:pid/organization/areas", (req, res) => {
+    const p = project(req, res);
+    if (!p) return;
+    try {
+      res.status(201).json(createArea(p.path, req.body || {}));
+    } catch (e) {
+      res.status(400).json({ error: e.message });
+    }
+  });
+
+  app.patch("/projects/:pid/organization/areas/:slug", (req, res) => {
+    const p = project(req, res);
+    if (!p) return;
+    try {
+      const area = updateArea(p.path, req.params.slug, req.body || {});
+      if (!area) return res.status(404).json({ error: "area not found" });
+      res.json(area);
+    } catch (e) {
+      res.status(400).json({ error: e.message });
+    }
+  });
+
+  app.delete("/projects/:pid/organization/areas/:slug", (req, res) => {
+    const p = project(req, res);
+    if (!p) return;
+    if (!removeArea(p.path, req.params.slug))
+      return res.status(404).json({ error: "area not found" });
+    res.json({ ok: true });
+  });
+
+  app.post("/projects/:pid/organization/roles", (req, res) => {
+    const p = project(req, res);
+    if (!p) return;
+    try {
+      res.status(201).json(createRole(p.path, req.body || {}));
+    } catch (e) {
+      res.status(400).json({ error: e.message });
+    }
+  });
+
+  app.patch("/projects/:pid/organization/roles/:slug", (req, res) => {
+    const p = project(req, res);
+    if (!p) return;
+    try {
+      const role = updateRole(p.path, req.params.slug, req.body || {});
+      if (!role) return res.status(404).json({ error: "role not found" });
+      res.json(role);
+    } catch (e) {
+      res.status(400).json({ error: e.message });
+    }
+  });
+
+  app.delete("/projects/:pid/organization/roles/:slug", (req, res) => {
+    const p = project(req, res);
+    if (!p) return;
+    if (!removeRole(p.path, req.params.slug))
+      return res.status(404).json({ error: "role not found" });
+    res.json({ ok: true });
+  });
+}

package/src/host/daemon/api/shared.js

@@ -210,6 +210,8 @@ export function agentToResponse(a) {
     "Parent",
     "Type",
     "Area",
+    "Emoji",
+    "Autonomy",
   ]);
   const extra = {};
   for (const [k, v] of Object.entries(f)) {
@@ -229,6 +231,11 @@ export function agentToResponse(a) {
     // definitional, kept in APC frontmatter.
     type: f.Type || null,
     area: f.Area || null,
+    // Display emoji (avatar) + autonomy (permission mode: total/automatico/
+    // permiso). Definitional, kept in APC frontmatter so they travel with the
+    // project and stay diffable.
+    emoji: f.Emoji || null,
+    autonomy: f.Autonomy || null,
     skills: Array.isArray(f.Skills) ? f.Skills : [],
     tools: Array.isArray(f.Tools) ? f.Tools : [],
     extra,

package/src/host/daemon/api/tasks.js

@@ -14,7 +14,9 @@ import {
   doneTask,
   dropTask,
   reopenTask,
+  setTaskStatus,
   countTasks,
+  TASK_STATUSES,
 } from "#core/stores/tasks.js";
 import { pageEnvelope } from "./shared.js";
 
@@ -113,6 +115,18 @@ export function register(app, { project, projects }) {
     res.json(updated);
   });
 
+  // Move an open task through its workflow (pending → running → in_review …).
+  app.post("/projects/:pid/tasks/:id/status", (req, res) => {
+    const p = project(req, res);
+    if (!p) return;
+    const { status } = req.body || {};
+    if (!TASK_STATUSES.includes(status))
+      return res.status(400).json({ error: `status must be one of ${TASK_STATUSES.join(", ")}` });
+    const updated = setTaskStatus(p.storagePath, req.params.id, status);
+    if (!updated) return res.status(404).json({ error: "task not found" });
+    res.json(updated);
+  });
+
   // Lightweight summary endpoint for status displays.
   app.get("/projects/:pid/tasks-summary", (req, res) => {
     const p = project(req, res);

package/src/host/daemon/api.js

@@ -33,6 +33,8 @@ import { register as registerRuntimes } from "./api/runtimes.js";
 import { register as registerRoutines } from "./api/routines.js";
 import { register as registerArtifacts } from "./api/artifacts.js";
 import { register as registerTasks } from "./api/tasks.js";
+import { register as registerOrganization } from "./api/organization.js";
+import { register as registerProjectFiles } from "./api/files-project.js";
 import { register as registerConfig } from "./api/config.js";
 import { register as registerRun } from "./api/run.js";
 import { register as registerTopLevel } from "./api/top-level.js";
@@ -121,6 +123,8 @@ export function buildApi({
   registerRoutines(app, ctx);
   registerArtifacts(app, ctx);
   registerTasks(app, ctx);
+  registerOrganization(app, ctx);
+  registerProjectFiles(app, ctx);
   registerConfig(app, ctx);
 
   // ---- Top-level shortcuts (MCP server clients) --------------------

package/src/interfaces/cli/commands/org.js

@@ -0,0 +1,77 @@
+// apx org — organization structure (areas + roles) for a project.
+// Backed by /projects/:pid/organization (core/stores/organization.js).
+//
+//   apx org show                                   [--project X]
+//   apx org area add "<name>" [--slug s] [--goal g] [--project X]
+//   apx org area rm <slug>                          [--project X]
+//   apx org role add "<name>" [--slug s] [--area a] [--desc d] [--project X]
+//   apx org role rm <slug>                          [--project X]
+//
+// Thin surface over the daemon API — the web panel calls the same routes.
+import { http } from "../http.js";
+import { resolveProjectId } from "./project.js";
+
+export const ORG_USAGE = {
+  show:     "apx org show [--project X]",
+  areaAdd:  'apx org area add "<name>" [--slug s] [--goal g] [--project X]',
+  areaRm:   "apx org area rm <slug> [--project X]",
+  roleAdd:  'apx org role add "<name>" [--slug s] [--area a] [--desc d] [--project X]',
+  roleRm:   "apx org role rm <slug> [--project X]",
+};
+
+function fail(key, msg) {
+  console.error(`apx org: ${msg}`);
+  console.error(`Usage: ${ORG_USAGE[key]}`);
+  process.exit(1);
+}
+
+export async function cmdOrgShow(args) {
+  const pid = await resolveProjectId(args?.flags?.project);
+  const org = await http.get(`/projects/${pid}/organization`);
+  if (!org.areas.length && !org.roles.length) {
+    console.log("(no organization structure yet)");
+    return;
+  }
+  console.log("Areas:");
+  for (const a of org.areas) console.log(`  • ${a.name} (${a.slug})${a.goal ? ` — ${a.goal}` : ""}`);
+  console.log("Roles:");
+  for (const r of org.roles) {
+    console.log(`  • ${r.name} (${r.slug})${r.area ? ` [${r.area}]` : ""}${r.description ? ` — ${r.description}` : ""}`);
+  }
+}
+
+export async function cmdOrgAreaAdd(args) {
+  const name = (args._ || []).slice(1).join(" ").trim();
+  if (!name) return fail("areaAdd", "name required");
+  const pid = await resolveProjectId(args?.flags?.project);
+  const area = await http.post(`/projects/${pid}/organization/areas`, {
+    name, slug: args.flags?.slug, goal: args.flags?.goal,
+  });
+  console.log(`added area ${area.name} (${area.slug})`);
+}
+
+export async function cmdOrgAreaRm(args) {
+  const slug = (args._ || [])[1];
+  if (!slug) return fail("areaRm", "slug required");
+  const pid = await resolveProjectId(args?.flags?.project);
+  await http.delete(`/projects/${pid}/organization/areas/${encodeURIComponent(slug)}`);
+  console.log(`removed area ${slug}`);
+}
+
+export async function cmdOrgRoleAdd(args) {
+  const name = (args._ || []).slice(1).join(" ").trim();
+  if (!name) return fail("roleAdd", "name required");
+  const pid = await resolveProjectId(args?.flags?.project);
+  const role = await http.post(`/projects/${pid}/organization/roles`, {
+    name, slug: args.flags?.slug, area: args.flags?.area, description: args.flags?.desc,
+  });
+  console.log(`added role ${role.name} (${role.slug})${role.area ? ` in ${role.area}` : ""}`);
+}
+
+export async function cmdOrgRoleRm(args) {
+  const slug = (args._ || [])[1];
+  if (!slug) return fail("roleRm", "slug required");
+  const pid = await resolveProjectId(args?.flags?.project);
+  await http.delete(`/projects/${pid}/organization/roles/${encodeURIComponent(slug)}`);
+  console.log(`removed role ${slug}`);
+}

package/src/interfaces/cli/index.js

@@ -140,6 +140,13 @@ import {
   cmdTaskReopen,
   cmdTaskPatch,
 } from "./commands/task.js";
+import {
+  cmdOrgShow,
+  cmdOrgAreaAdd,
+  cmdOrgAreaRm,
+  cmdOrgRoleAdd,
+  cmdOrgRoleRm,
+} from "./commands/org.js";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -1531,6 +1538,24 @@ const HELP_TOPICS = new Map(Object.entries({
     usage: ["apx tasks <subcommand> [args] [--flags]"],
     examples: ["apx tasks list"],
   }),
+  org: topic({
+    title: "apx org",
+    summary: "Organization structure (areas + roles) for a project — the org chart companies/enterprises use to group agents.",
+    usage: ["apx org <show|area|role> [args] [--flags]"],
+    commands: [
+      ["show | list", "Print the project's areas and roles."],
+      ["area add \"<name>\"", "Create an area. --slug, --goal optional."],
+      ["area rm <slug>", "Remove an area (its roles are detached, not deleted)."],
+      ["role add \"<name>\"", "Create a role. --slug, --area, --desc optional."],
+      ["role rm <slug>", "Remove a role."],
+    ],
+    options: [["--project <name|id|path>", "Pin command to a specific project."]],
+    examples: [
+      "apx org area add \"Engineering\" --goal \"Build the product\"",
+      "apx org role add \"Tech Lead\" --area engineering",
+      "apx org show",
+    ],
+  }),
   "task add": topic({
     title: "apx task add",
     summary: "Create a task on a project's TODO list.",
@@ -2604,6 +2629,29 @@ async function dispatch(cmd, rest) {
         break;
       }
 
+      case "org":
+      case "organization": {
+        const sub = rest[0];
+        const a = parseArgs(rest.slice(1));
+        // `apx org area add ...` / `apx org role rm ...` — the resource verb is
+        // the first positional, the action the second.
+        if (!sub || sub === "show" || sub === "list") await cmdOrgShow(a);
+        else if (sub === "area") {
+          const action = rest[1];
+          const aa = parseArgs(rest.slice(1)); // keep `area` as _[0] for name parsing
+          if (action === "add" || action === "new") await cmdOrgAreaAdd(aa);
+          else if (action === "rm" || action === "remove" || action === "delete") await cmdOrgAreaRm(aa);
+          else die("usage: apx org area <add|rm> ...");
+        } else if (sub === "role") {
+          const action = rest[1];
+          const ra = parseArgs(rest.slice(1));
+          if (action === "add" || action === "new") await cmdOrgRoleAdd(ra);
+          else if (action === "rm" || action === "remove" || action === "delete") await cmdOrgRoleRm(ra);
+          else die("usage: apx org role <add|rm> ...");
+        } else die(`unknown org subcommand: ${sub}\nUsage: apx org <show|area|role> ...`);
+        break;
+      }
+
       case "skills": {
         const sub = rest[0];
         const a = parseArgs(rest.slice(1));