@kb-labs/steward-entry 0.1.0

package/dist/manifest.d.ts

@@ -0,0 +1,490 @@
+import * as _kb_labs_plugin_contracts from '@kb-labs/plugin-contracts';
+
+declare const manifest: {
+    readonly schema: "kb.plugin/3";
+    readonly id: "@kb-labs/steward";
+    readonly version: "0.1.0";
+    readonly display: {
+        readonly name: "Steward";
+        readonly description: "Personal PM/CRM tool-layer for AI agents: projects, people, commitments, and routing across dozens of parallel projects.";
+        readonly tags: readonly ["pm", "crm", "agents", "productivity"];
+    };
+    readonly platform: {
+        readonly requires: readonly ["documentDatabase"];
+    };
+    readonly cli: {
+        readonly groupMeta: readonly [{
+            readonly name: "steward";
+            readonly description: "Personal PM/CRM for AI agents";
+        }];
+        readonly commands: readonly [{
+            readonly path: "steward project add";
+            readonly describe: "Create a new project";
+            readonly handler: "./commands/project-add.js#default";
+            readonly flags: readonly [{
+                readonly name: "name";
+                readonly type: "string";
+                readonly description: "Project name";
+                readonly required: true;
+            }, {
+                readonly name: "status";
+                readonly type: "string";
+                readonly description: "active | paused | archived";
+                readonly default: "active";
+            }, {
+                readonly name: "description";
+                readonly type: "string";
+                readonly description: "Free-text description";
+            }, {
+                readonly name: "json";
+                readonly type: "boolean";
+                readonly description: "Emit JSON instead of text";
+            }];
+            readonly examples: readonly ["kb steward project add --name=\"Acme API\" --description=\"Payments backend\""];
+        }, {
+            readonly path: "steward project get";
+            readonly describe: "Get a project card: status, resources, and members";
+            readonly handler: "./commands/project-get.js#default";
+            readonly flags: readonly [{
+                readonly name: "json";
+                readonly type: "boolean";
+                readonly description: "Emit JSON instead of text";
+            }];
+            readonly examples: readonly ["kb steward project get \"Acme API\"", "kb steward project get prj_01H..."];
+        }, {
+            readonly path: "steward project list";
+            readonly describe: "List projects, optionally filtered by status";
+            readonly handler: "./commands/project-list.js#default";
+            readonly flags: readonly [{
+                readonly name: "status";
+                readonly type: "string";
+                readonly description: "active | paused | archived";
+            }, {
+                readonly name: "json";
+                readonly type: "boolean";
+                readonly description: "Emit JSON instead of text";
+            }];
+            readonly examples: readonly ["kb steward project list", "kb steward project list --status=active"];
+        }, {
+            readonly path: "steward project update";
+            readonly describe: "Update a project's status or description";
+            readonly handler: "./commands/project-update.js#default";
+            readonly flags: readonly [{
+                readonly name: "status";
+                readonly type: "string";
+                readonly description: "active | paused | archived";
+            }, {
+                readonly name: "description";
+                readonly type: "string";
+                readonly description: "New description";
+            }, {
+                readonly name: "json";
+                readonly type: "boolean";
+                readonly description: "Emit JSON instead of text";
+            }];
+            readonly examples: readonly ["kb steward project update prj_01H... --status=paused"];
+        }, {
+            readonly path: "steward resource add";
+            readonly describe: "Attach a resource to a project (repo, stand, dashboard, doc, ...)";
+            readonly handler: "./commands/resource-add.js#default";
+            readonly flags: readonly [{
+                readonly name: "type";
+                readonly type: "string";
+                readonly description: "Free-form kind, e.g. repo, dev-stand, dashboard";
+                readonly required: true;
+            }, {
+                readonly name: "label";
+                readonly type: "string";
+                readonly description: "Human-readable label";
+                readonly required: true;
+            }, {
+                readonly name: "url";
+                readonly type: "string";
+                readonly description: "External link, if any";
+            }, {
+                readonly name: "content";
+                readonly type: "string";
+                readonly description: "Stored markdown content, if any";
+            }, {
+                readonly name: "json";
+                readonly type: "boolean";
+                readonly description: "Emit JSON instead of text";
+            }];
+            readonly examples: readonly ["kb steward resource add prj_01H... --type=repo --url=https://github.com/acme/api"];
+        }, {
+            readonly path: "steward resource list";
+            readonly describe: "List resources attached to a project";
+            readonly handler: "./commands/resource-list.js#default";
+            readonly flags: readonly [{
+                readonly name: "json";
+                readonly type: "boolean";
+                readonly description: "Emit JSON instead of text";
+            }];
+            readonly examples: readonly ["kb steward resource list prj_01H..."];
+        }, {
+            readonly path: "steward person add";
+            readonly describe: "Add a contact. Returns a possibleDuplicates warning, not an error, on a name match";
+            readonly handler: "./commands/person-add.js#default";
+            readonly flags: readonly [{
+                readonly name: "name";
+                readonly type: "string";
+                readonly description: "Full name";
+                readonly required: true;
+            }, {
+                readonly name: "topics";
+                readonly type: "string";
+                readonly description: "Comma-separated global competencies";
+            }, {
+                readonly name: "company";
+                readonly type: "string";
+                readonly description: "Company id";
+            }, {
+                readonly name: "json";
+                readonly type: "boolean";
+                readonly description: "Emit JSON instead of text";
+            }];
+            readonly examples: readonly ["kb steward person add --name=\"Ivanov\" --topics=frontend,architecture"];
+        }, {
+            readonly path: "steward person update";
+            readonly describe: "Update a contact's name, topics, or company";
+            readonly handler: "./commands/person-update.js#default";
+            readonly flags: readonly [{
+                readonly name: "name";
+                readonly type: "string";
+                readonly description: "New name";
+            }, {
+                readonly name: "topics";
+                readonly type: "string";
+                readonly description: "Comma-separated global competencies (replaces existing)";
+            }, {
+                readonly name: "company";
+                readonly type: "string";
+                readonly description: "Company id";
+            }, {
+                readonly name: "json";
+                readonly type: "boolean";
+                readonly description: "Emit JSON instead of text";
+            }];
+            readonly examples: readonly ["kb steward person update per_01H... --topics=frontend,backend"];
+        }, {
+            readonly path: "steward person get";
+            readonly describe: "Get a contact by id or exact name";
+            readonly handler: "./commands/person-get.js#default";
+            readonly flags: readonly [{
+                readonly name: "json";
+                readonly type: "boolean";
+                readonly description: "Emit JSON instead of text";
+            }];
+            readonly examples: readonly ["kb steward person get \"Ivanov\""];
+        }, {
+            readonly path: "steward person list";
+            readonly describe: "List every known contact";
+            readonly handler: "./commands/person-list.js#default";
+            readonly flags: readonly [{
+                readonly name: "json";
+                readonly type: "boolean";
+                readonly description: "Emit JSON instead of text";
+            }];
+            readonly examples: readonly ["kb steward person list"];
+        }, {
+            readonly path: "steward company add";
+            readonly describe: "Add a company (thin — just a name to link people to)";
+            readonly handler: "./commands/company-add.js#default";
+            readonly flags: readonly [{
+                readonly name: "name";
+                readonly type: "string";
+                readonly description: "Company name";
+                readonly required: true;
+            }, {
+                readonly name: "json";
+                readonly type: "boolean";
+                readonly description: "Emit JSON instead of text";
+            }];
+            readonly examples: readonly ["kb steward company add --name=\"Acme Corp\""];
+        }, {
+            readonly path: "steward company list";
+            readonly describe: "List companies";
+            readonly handler: "./commands/company-list.js#default";
+            readonly flags: readonly [{
+                readonly name: "json";
+                readonly type: "boolean";
+                readonly description: "Emit JSON instead of text";
+            }];
+            readonly examples: readonly ["kb steward company list"];
+        }, {
+            readonly path: "steward member add";
+            readonly describe: "Link a person to a project with a role and fallback priority";
+            readonly handler: "./commands/member-add.js#default";
+            readonly flags: readonly [{
+                readonly name: "person";
+                readonly type: "string";
+                readonly description: "Person id";
+                readonly required: true;
+            }, {
+                readonly name: "project";
+                readonly type: "string";
+                readonly description: "Project id";
+                readonly required: true;
+            }, {
+                readonly name: "role";
+                readonly type: "string";
+                readonly description: "Role in this project";
+                readonly required: true;
+            }, {
+                readonly name: "topics";
+                readonly type: "string";
+                readonly description: "Comma-separated project-scoped competencies";
+            }, {
+                readonly name: "priority";
+                readonly type: "number";
+                readonly description: "Lower = contacted first";
+                readonly default: 0;
+            }, {
+                readonly name: "json";
+                readonly type: "boolean";
+                readonly description: "Emit JSON instead of text";
+            }];
+            readonly examples: readonly ["kb steward member add --person=per_01H... --project=prj_01H... --role=lead --priority=0"];
+        }, {
+            readonly path: "steward member list";
+            readonly describe: "List members of a project, ordered by fallback priority";
+            readonly handler: "./commands/member-list.js#default";
+            readonly flags: readonly [{
+                readonly name: "json";
+                readonly type: "boolean";
+                readonly description: "Emit JSON instead of text";
+            }];
+            readonly examples: readonly ["kb steward member list prj_01H..."];
+        }, {
+            readonly path: "steward who";
+            readonly describe: "Find who to contact about a topic. With --project, project-scoped members take priority (fallback chain); otherwise matches global competencies across every contact";
+            readonly handler: "./commands/who.js#default";
+            readonly flags: readonly [{
+                readonly name: "project";
+                readonly type: "string";
+                readonly description: "Prefer members of this project";
+            }, {
+                readonly name: "json";
+                readonly type: "boolean";
+                readonly description: "Emit JSON instead of text";
+            }];
+            readonly examples: readonly ["kb steward who \"frontend\" --project=prj_01H...", "kb steward who \"grafana\""];
+        }, {
+            readonly path: "steward commitment add";
+            readonly describe: "Record a promise made to a person, with an optional soft reminder date";
+            readonly handler: "./commands/commitment-add.js#default";
+            readonly flags: readonly [{
+                readonly name: "text";
+                readonly type: "string";
+                readonly description: "What was promised";
+                readonly required: true;
+            }, {
+                readonly name: "person";
+                readonly type: "string";
+                readonly description: "Person id";
+            }, {
+                readonly name: "project";
+                readonly type: "string";
+                readonly description: "Project id";
+            }, {
+                readonly name: "remind-at";
+                readonly type: "string";
+                readonly description: "ISO date/time for the reminder";
+            }, {
+                readonly name: "stale-after-days";
+                readonly type: "number";
+                readonly description: "Days of silence before it counts as stale";
+                readonly default: 14;
+            }, {
+                readonly name: "json";
+                readonly type: "boolean";
+                readonly description: "Emit JSON instead of text";
+            }];
+            readonly examples: readonly ["kb steward commitment add --text=\"Send X\" --person=per_01H... --remind-at=2026-09-01"];
+        }, {
+            readonly path: "steward commitment list";
+            readonly describe: "List commitments, optionally only the stale (overdue, unsnoozed) ones";
+            readonly handler: "./commands/commitment-list.js#default";
+            readonly flags: readonly [{
+                readonly name: "status";
+                readonly type: "string";
+                readonly description: "open | done | dropped";
+            }, {
+                readonly name: "project";
+                readonly type: "string";
+                readonly description: "Project id";
+            }, {
+                readonly name: "stale-only";
+                readonly type: "boolean";
+                readonly description: "Only overdue, unsnoozed, open commitments";
+            }, {
+                readonly name: "json";
+                readonly type: "boolean";
+                readonly description: "Emit JSON instead of text";
+            }];
+            readonly examples: readonly ["kb steward commitment list --stale-only"];
+        }, {
+            readonly path: "steward commitment done";
+            readonly describe: "Mark a commitment fulfilled";
+            readonly handler: "./commands/commitment-done.js#default";
+            readonly flags: readonly [{
+                readonly name: "json";
+                readonly type: "boolean";
+                readonly description: "Emit JSON instead of text";
+            }];
+            readonly examples: readonly ["kb steward commitment done cmt_01H..."];
+        }, {
+            readonly path: "steward commitment drop";
+            readonly describe: "Cancel a commitment — reason is required and recorded in history";
+            readonly handler: "./commands/commitment-drop.js#default";
+            readonly flags: readonly [{
+                readonly name: "reason";
+                readonly type: "string";
+                readonly description: "Why it was dropped";
+                readonly required: true;
+            }, {
+                readonly name: "json";
+                readonly type: "boolean";
+                readonly description: "Emit JSON instead of text";
+            }];
+            readonly examples: readonly ["kb steward commitment drop cmt_01H... --reason=\"No longer relevant\""];
+        }, {
+            readonly path: "steward commitment snooze";
+            readonly describe: "Postpone a commitment's reminder without cancelling it";
+            readonly handler: "./commands/commitment-snooze.js#default";
+            readonly flags: readonly [{
+                readonly name: "until";
+                readonly type: "string";
+                readonly description: "ISO date/time to snooze until";
+                readonly required: true;
+            }, {
+                readonly name: "reason";
+                readonly type: "string";
+                readonly description: "Why it was postponed";
+            }, {
+                readonly name: "json";
+                readonly type: "boolean";
+                readonly description: "Emit JSON instead of text";
+            }];
+            readonly examples: readonly ["kb steward commitment snooze cmt_01H... --until=2026-09-15 --reason=\"Waiting on client\""];
+        }, {
+            readonly path: "steward event add";
+            readonly describe: "Record a manual note against a project, person, or commitment — the primary tool for backfill import";
+            readonly handler: "./commands/event-add.js#default";
+            readonly flags: readonly [{
+                readonly name: "subject-type";
+                readonly type: "string";
+                readonly description: "project | person | commitment | company | resource";
+                readonly required: true;
+            }, {
+                readonly name: "subject-id";
+                readonly type: "string";
+                readonly description: "Id of the subject";
+                readonly required: true;
+            }, {
+                readonly name: "text";
+                readonly type: "string";
+                readonly description: "Note text";
+            }, {
+                readonly name: "kind";
+                readonly type: "string";
+                readonly description: "Event kind";
+                readonly default: "note";
+            }, {
+                readonly name: "json";
+                readonly type: "boolean";
+                readonly description: "Emit JSON instead of text";
+            }];
+            readonly examples: readonly ["kb steward event add --subject-type=person --subject-id=per_01H... --text=\"Talked at the conference\""];
+        }, {
+            readonly path: "steward event list";
+            readonly describe: "Read the history log for a subject — \"what happened with X\"";
+            readonly handler: "./commands/event-list.js#default";
+            readonly flags: readonly [{
+                readonly name: "subject-type";
+                readonly type: "string";
+                readonly description: "project | person | commitment | company | resource";
+            }, {
+                readonly name: "subject-id";
+                readonly type: "string";
+                readonly description: "Id of the subject";
+            }, {
+                readonly name: "kind";
+                readonly type: "string";
+                readonly description: "Filter by event kind";
+            }, {
+                readonly name: "json";
+                readonly type: "boolean";
+                readonly description: "Emit JSON instead of text";
+            }];
+            readonly examples: readonly ["kb steward event list --subject-type=project --subject-id=prj_01H..."];
+        }, {
+            readonly path: "steward topic add";
+            readonly describe: "Register a topic with aliases in the routing dictionary — do this deliberately, not automatically";
+            readonly handler: "./commands/topic-add.js#default";
+            readonly flags: readonly [{
+                readonly name: "name";
+                readonly type: "string";
+                readonly description: "Canonical topic name";
+                readonly required: true;
+            }, {
+                readonly name: "aliases";
+                readonly type: "string";
+                readonly description: "Comma-separated aliases";
+            }, {
+                readonly name: "json";
+                readonly type: "boolean";
+                readonly description: "Emit JSON instead of text";
+            }];
+            readonly examples: readonly ["kb steward topic add --name=frontend --aliases=фронт,фронтенд,front-end"];
+        }, {
+            readonly path: "steward topic list";
+            readonly describe: "List the topic dictionary";
+            readonly handler: "./commands/topic-list.js#default";
+            readonly flags: readonly [{
+                readonly name: "json";
+                readonly type: "boolean";
+                readonly description: "Emit JSON instead of text";
+            }];
+            readonly examples: readonly ["kb steward topic list"];
+        }, {
+            readonly path: "steward review";
+            readonly describe: "Daily summary: stale commitments, upcoming reminders, active projects, and days since the last successful backup";
+            readonly handler: "./commands/review.js#default";
+            readonly flags: readonly [{
+                readonly name: "json";
+                readonly type: "boolean";
+                readonly description: "Emit JSON instead of text";
+            }];
+            readonly examples: readonly ["kb steward review"];
+        }];
+    };
+    readonly cron: {
+        readonly schedules: readonly [_kb_labs_plugin_contracts.CronDecl, _kb_labs_plugin_contracts.CronDecl];
+    };
+    readonly jobs: {
+        readonly handlers: readonly [{
+            readonly id: "daily-review";
+            readonly describe: "Writes .kb/steward/reviews/<date>.md";
+            readonly handler: "./jobs/daily-review.js#default";
+        }, {
+            readonly id: "export-backup";
+            readonly describe: "Writes .kb/steward/exports/<date>.json — git commit/push happens at the workflow level";
+            readonly handler: "./jobs/export-backup.js#default";
+        }];
+    };
+    readonly artifacts: readonly [{
+        readonly id: "steward.review.md";
+        readonly pathTemplate: ".kb/steward/reviews/{date}.md";
+        readonly description: "Daily review — stale commitments, upcoming reminders, backup health.";
+    }, {
+        readonly id: "steward.export.json";
+        readonly pathTemplate: ".kb/steward/exports/{date}.json";
+        readonly description: "Daily snapshot of every collection, for the private-repo backup.";
+    }];
+};
+declare const withPermissions: typeof manifest & {
+    permissions: unknown;
+};
+
+export { withPermissions as default };