@stravica-ai/digital-operator-pa 0.1.0

package/dist/engineering-pa-core/schema/autonomy-envelope.schema.json

@@ -0,0 +1,61 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "autonomy-envelope.json",
+  "title": "Autonomy Envelope",
+  "description": "Per-agent per-task-type approval-state record. Frontmatter section of `agents/<paName>/autonomy-envelope.md`. Body is markdown table + history log.",
+  "type": "object",
+  "required": ["agent", "owner", "updated", "taskTypes"],
+  "additionalProperties": false,
+  "properties": {
+    "agent": {
+      "type": "string",
+      "minLength": 1,
+      "description": "The agent's short name (matches agents/<name>/ directory)."
+    },
+    "owner": {
+      "type": "string",
+      "minLength": 1,
+      "description": "The operator name (informational; the operator whose PA this envelope belongs to)."
+    },
+    "updated": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 timestamp of last change."
+    },
+    "taskTypes": {
+      "type": "array",
+      "description": "One entry per task type. Order is operator-facing; the CLI preserves it.",
+      "items": {
+        "type": "object",
+        "required": ["id", "label", "state"],
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[a-z0-9][a-z0-9-]*$",
+            "description": "Task-type slug (e.g. li-comment-draft, code-dispatch, git-commit-push)."
+          },
+          "label": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Human-readable name."
+          },
+          "state": {
+            "type": "string",
+            "enum": ["fullyApproved", "checkBeforeCommitting", "needsFullSupervision"],
+            "description": "Approval state for this task type."
+          },
+          "stateSince": {
+            "type": "string",
+            "format": "date-time",
+            "description": "ISO 8601 timestamp of when this state was set."
+          },
+          "operatorNote": {
+            "type": "string",
+            "description": "Free-text reason from the operator."
+          }
+        }
+      }
+    }
+  }
+}

package/dist/engineering-pa-core/schema/project.json

@@ -0,0 +1,114 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "project.json",
+  "title": "Project Manifest",
+  "description": "A project manifest describing a tracked project.",
+  "type": "object",
+  "required": ["id", "name", "status", "created"],
+  "additionalProperties": false,
+  "definitions": {
+    "docEntry": {
+      "type": "object",
+      "required": ["label", "path"],
+      "additionalProperties": false,
+      "properties": {
+        "label": {
+          "type": "string",
+          "description": "Display label for the document"
+        },
+        "path": {
+          "type": "string",
+          "pattern": "^[^/]",
+          "description": "Repo-root-relative path to the document. Must NOT start with a leading slash — the file API resolves paths relative to repo root and rejects absolute paths."
+        }
+      }
+    }
+  },
+  "properties": {
+    "id": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Unique project identifier (slug)"
+    },
+    "number": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Sequential project number for display"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Human-readable project name"
+    },
+    "category": {
+      "type": "string",
+      "description": "Project category"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["draft", "planned", "in-progress", "blocked", "done", "archived"],
+      "description": "Current project status"
+    },
+    "priority": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 3,
+      "description": "Priority level: 0 (critical) to 3 (low)"
+    },
+    "lead": {
+      "type": "string",
+      "description": "Project lead"
+    },
+    "owner": {
+      "type": "string",
+      "description": "Long-term project owner"
+    },
+    "assignee": {
+      "type": "string",
+      "description": "Whose move it is right now"
+    },
+    "executor": {
+      "type": "string",
+      "description": "Who is executing the project"
+    },
+    "created": {
+      "type": "string",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+      "description": "Creation date in YYYY-MM-DD format"
+    },
+    "updated": {
+      "type": "string",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+      "description": "Last-update date in YYYY-MM-DD format"
+    },
+    "shipped": {
+      "type": ["string", "null"],
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+      "description": "Ship date in YYYY-MM-DD format, or null"
+    },
+    "path": {
+      "type": "string",
+      "description": "Relative path to the project directory"
+    },
+    "summary": {
+      "type": "string",
+      "description": "Brief project summary"
+    },
+    "docs": {
+      "description": "Related documentation. Two shapes are accepted: a flat array of {label, path} entries (legacy), or an object keyed by group name → array of entries (current). The pa CLI writes the grouped shape; the workspace UI renders both.",
+      "oneOf": [
+        {
+          "type": "array",
+          "items": { "$ref": "#/definitions/docEntry" }
+        },
+        {
+          "type": "object",
+          "additionalProperties": {
+            "type": "array",
+            "items": { "$ref": "#/definitions/docEntry" }
+          }
+        }
+      ]
+    }
+  }
+}

package/dist/engineering-pa-core/schema/schedule.json

@@ -0,0 +1,63 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Dave Schedule Definition",
+  "description": "Defines a recurring scheduled task managed by the Dave scheduler",
+  "type": "object",
+  "required": ["id", "schedule", "command"],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]*[a-z0-9]$",
+      "description": "Unique identifier for the schedule. Used in backend naming (com.{agent}.{id}, dave-{id}). Lowercase alphanumeric with hyphens."
+    },
+    "agent": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]*[a-z0-9]$",
+      "default": "dave",
+      "description": "Agent that owns this schedule. Drives the launchd label prefix (com.{agent}.{id}); other backends are unaffected. Omit for the pre-existing default agent 'dave' — every schedule file without this field keeps producing exactly com.dave.{id}, unchanged."
+    },
+    "name": {
+      "type": "string",
+      "description": "Human-readable display name"
+    },
+    "schedule": {
+      "type": "string",
+      "pattern": "^[0-9*,/-]+ [0-9*,/-]+ [0-9*,/-]+ [0-9*,/-]+ [0-9*,/-]+$",
+      "description": "Cron expression: minute hour day-of-month month day-of-week. This is the universal format -- install.mjs translates to the native backend format."
+    },
+    "command": {
+      "type": "string",
+      "description": "Shell command to execute. Runs via bash."
+    },
+    "workingDirectory": {
+      "type": "string",
+      "default": "${DAVE_ROOT}",
+      "description": "Working directory for the command. Supports ${DAVE_ROOT} variable substitution."
+    },
+    "enabled": {
+      "type": "boolean",
+      "default": true,
+      "description": "Whether the schedule is active. Disabled schedules are skipped by install.mjs."
+    },
+    "backend": {
+      "type": ["string", "null"],
+      "enum": ["cron", "launchd", "systemd", "schtasks", null],
+      "default": null,
+      "description": "Override the backend for this schedule. Null uses the deployment default from .dave/config.json."
+    },
+    "description": {
+      "type": "string",
+      "description": "Human-readable description of what this schedule does"
+    },
+    "host": {
+      "type": "string",
+      "description": "Device id or hostname this schedule is pinned to run on, matched against the current machine's hostname (exact, then short-name-before-first-dot) by `scheduler install` and `launch`. A mismatch refuses (exit 2) unless overridden (--force-host for install; DAVE_FORCE_HOST=1 for launch). Omit to skip host verification (data backfill onto existing schedule files is estate-side)."
+    },
+    "environment": {
+      "type": "object",
+      "description": "Environment variables to set for the scheduled process. Keys are variable names, values are strings supporting ${DAVE_ROOT}/${HOME}/${USER} substitution. On launchd, injected as EnvironmentVariables (merged over auto-injected PATH/HOME/DAVE_ROOT defaults; explicit keys win). On systemd, emitted as Environment= lines in [Service]. On cron, prepended as VAR='val' inline assignments before the command. On schtasks, emitted as `set VAR=val &&` pairs inside the cmd /c wrapper. WARNING: do NOT set PATH, HOME, or DAVE_ROOT here unless you genuinely need to override the installer's auto-injected values. On launchd in particular, an explicit PATH wins over withLaunchdDefaults() and almost always omits /opt/homebrew/bin, silently breaking brew-installed binaries on Apple Silicon. Use this block only for operator-meaningful keys (API_KEY, LOG_LEVEL, feature flags); leave PATH/HOME/DAVE_ROOT to the installer.",
+      "additionalProperties": { "type": "string" }
+    }
+  },
+  "additionalProperties": false
+}

package/dist/engineering-pa-core/schema/work-item.json

@@ -0,0 +1,92 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "work-item.json",
+  "title": "Work Item",
+  "description": "A trackable unit of work in the task management system.",
+  "type": "object",
+  "required": ["id", "title", "status", "owner", "created"],
+  "additionalProperties": false,
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^w-\\d{4}-\\d{2}-\\d{2}-\\d{3}$",
+      "description": "Work item identifier in the format w-YYYY-MM-DD-NNN"
+    },
+    "projectId": {
+      "type": ["string", "null"],
+      "description": "Associated project identifier, or null if standalone"
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Short descriptive title"
+    },
+    "category": {
+      "type": "string",
+      "enum": ["feature", "bug", "chore", "discussion", "research"],
+      "description": "Work item category"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["draft", "planned", "in-progress", "blocked", "done", "archived"],
+      "description": "Current workflow status"
+    },
+    "priority": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 3,
+      "description": "Priority level: 0 (critical) to 3 (low)"
+    },
+    "owner": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Long-term accountability — who owns the outcome"
+    },
+    "assignee": {
+      "type": "string",
+      "description": "Whose move it is right now"
+    },
+    "created": {
+      "type": "string",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+      "description": "Creation date in YYYY-MM-DD format"
+    },
+    "updated": {
+      "type": "string",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+      "description": "Last update date in YYYY-MM-DD format"
+    },
+    "completedAt": {
+      "type": ["string", "null"],
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+      "description": "Completion date in YYYY-MM-DD format, or null"
+    },
+    "summary": {
+      "type": "string",
+      "description": "Longer description of the work item"
+    },
+    "blocked": {
+      "type": ["string", "null"],
+      "description": "Description of what is blocking this item, or null"
+    },
+    "links": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["label", "path"],
+        "additionalProperties": false,
+        "properties": {
+          "label": {
+            "type": "string",
+            "description": "Display label for the link"
+          },
+          "path": {
+            "type": "string",
+            "description": "Relative path or URL"
+          }
+        }
+      },
+      "description": "Related links (docs, specs, PRs, etc.)"
+    }
+  }
+}

package/dist/engineering-pa-core/src/config/pa-package-name.mjs

@@ -0,0 +1,30 @@
+// pa-package-name.mjs — canonical name of the published operator-facing bundle.
+//
+// Single source of indirection for runtime references to the package name
+// in user-facing output and in runtime path constructions that resolve
+// inside the installed bundle. Introduced in the `digital-operator-pa-rename`
+// project's Phase 1 (config-constant indirection) so that Phase 2's
+// wholesale rename to `@stravica-ai/digital-operator-pa` is a one-line
+// value flip here rather than a scattered string edit across the CLI
+// surface.
+//
+// Scope of use:
+//   - Runtime-printed strings in CLIs (help text, version banners, error
+//     messages, log lines) that mention the package by name.
+//   - Runtime path constructions that resolve inside the installed bundle
+//     (e.g. `node_modules/${PA_PACKAGE_NAME}/bin/<cmd>`,
+//     `node_modules/${PA_PACKAGE_NAME}/package.json`).
+//
+// Deliberately NOT sourced from here (each stays literal until Phase 2's
+// wholesale codemod flips them together):
+//   - `package.json:name` — canonical self-declaration; changes literally.
+//   - `import` / `require` module specifiers — module identifiers change
+//     literally in the Phase 2 codemod.
+//   - Sub-package identifiers (`@stravica-ai/engineering-pa-cli`,
+//     `-core`, `-workspace`, etc.) — separately owned; all flip together.
+//   - Markdown docs / READMEs — can't participate in JS indirection;
+//     folded into Phase 2's codemod PR.
+//   - Historical narrative comments and test assertions — not runtime
+//     surfaces; the tests test known-name-is-known-name.
+
+export const PA_PACKAGE_NAME = '@stravica-ai/digital-operator-pa';

package/dist/engineering-pa-core/src/desk/cli.mjs

@@ -0,0 +1,95 @@
+// desk — CLI router
+//
+// Read-only view over the workflow. Walks projects/*/project.json
+// and work/*.json on every invocation. No caching, no state files of
+// its own — source of truth is the repo.
+
+import { projectsList, projectShow, workList, workShow, overview, today } from './commands.mjs';
+
+const USAGE = `
+desk — task management CLI
+
+  desk                                Show overview (default)
+  desk overview                       Show overview
+  desk overview --all-teams           Include other-team projects
+  desk overview --team <identity>     Show only one team's projects
+  desk today                          Show everything created/updated today
+  desk today --all-teams              Include other-team projects
+  desk today --team <identity>        Show only one team's projects
+
+  desk projects                       List active projects
+  desk projects --all                 Include done and archived
+  desk projects --all-teams           Include other-team projects
+  desk projects --team <identity>     Show only one team's projects
+  desk projects --json                Raw JSON output
+  desk projects show <id>             Show one project
+
+  desk work                           List active work items
+  desk work --all                     Include done and archived
+  desk work --mine                    Items assigned to the PA
+  desk work --theirs                  Items assigned to the operator
+  desk work --assignee <role>         Filter by assignee role (or 'unassigned')
+  desk work --status <s>              Filter by status
+  desk work --project <id>            Filter by project
+  desk work --category <c>            Filter by category
+  desk work --owner <role>            Filter by owner role
+  desk work --json                    Raw JSON output
+  desk work show <id>                 Show one work item
+
+  desk -h, --help                     Show this help
+
+States: draft, planned, in-progress, blocked, done, archived
+Categories: feature, bug, chore, discussion, research
+Assignee semantics: owner = long-term accountability; assignee = whose
+move it is right now. "on me" = PA, "on you" = operator.
+
+Team scoping: projects are scoped by executor (falling back to assignee)
+against the team-identity set when operator/config/preferences.json sets
+"scopeProjectsToTeam": true. The set is "teamIdentities" (string[], mixed
+agent names and role names, e.g. ["dave", "system-architect"]) when
+present, else [paName]; paName is always a member regardless. With no
+config, every view shows all projects (unchanged pre-scoping behaviour).
+Projects with neither field set are always shown (fail open). --all-teams
+and --team <identity> bypass/override the default on every view that
+lists projects.
+
+Source of truth:
+  projects/{id}/project.json
+  work/{id}.json
+
+Exit codes: 0 ok, 1 usage/not-found, 2 internal error.
+`;
+
+export async function run(argv) {
+  if (!argv.length) return overview([]);
+  const cmd = argv[0];
+  const rest = argv.slice(1);
+
+  if (cmd === '-h' || cmd === '--help') {
+    console.log(USAGE.trim());
+    return 0;
+  }
+
+  if (cmd === 'overview') return overview(rest);
+  if (cmd === 'today') return today(rest);
+
+  if (cmd === 'projects') {
+    const sub = rest[0];
+    if (sub === 'show') return projectShow(rest.slice(1));
+    if (sub === 'list' || sub == null || sub.startsWith('-')) return projectsList(rest[0]?.startsWith('-') ? rest : rest.slice(1));
+    console.error(`unknown projects subcommand: ${sub}`);
+    return 1;
+  }
+
+  if (cmd === 'work') {
+    const sub = rest[0];
+    if (sub === 'show') return workShow(rest.slice(1));
+    if (sub === 'list' || sub == null || sub.startsWith('-')) return workList(rest[0]?.startsWith('-') ? rest : rest.slice(1));
+    console.error(`unknown work subcommand: ${sub}`);
+    return 1;
+  }
+
+  console.error(`unknown command: ${cmd}`);
+  console.error('Run `desk --help` for usage.');
+  return 1;
+}