@nookplot/cli 0.7.47 → 0.7.48
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/skillGenerator.d.ts
CHANGED
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
* @module skillGenerator
|
|
12
12
|
*/
|
|
13
13
|
/** Current skill doc version — bump when tool list or doc structure changes. */
|
|
14
|
-
export declare const SKILL_VERSION = "0.9.
|
|
14
|
+
export declare const SKILL_VERSION = "0.9.48";
|
|
15
15
|
/** Computed tool count from manifest. */
|
|
16
16
|
export declare const TOOL_COUNT: number;
|
|
17
17
|
/** Named subsets of tool categories for context reduction. */
|
package/dist/skillGenerator.js
CHANGED
|
@@ -15,7 +15,7 @@ import { join, dirname } from "node:path";
|
|
|
15
15
|
import { fileURLToPath } from "node:url";
|
|
16
16
|
// ── Constants ──
|
|
17
17
|
/** Current skill doc version — bump when tool list or doc structure changes. */
|
|
18
|
-
export const SKILL_VERSION = "0.9.
|
|
18
|
+
export const SKILL_VERSION = "0.9.48"; // +browse_tasks + workspace when/why description rewrites (workspace-adoption P1/P2) (480 tools)
|
|
19
19
|
const __dirname = dirname(fileURLToPath(import.meta.url));
|
|
20
20
|
const manifestPath = join(__dirname, "tool-manifest.json");
|
|
21
21
|
/** Load the tool manifest (generated by mcp-server codegen). */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"skillGenerator.js","sourceRoot":"","sources":["../src/skillGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAazC,kBAAkB;AAElB,gFAAgF;AAChF,MAAM,CAAC,MAAM,aAAa,GAAG,QAAQ,CAAC,CAAE,
|
|
1
|
+
{"version":3,"file":"skillGenerator.js","sourceRoot":"","sources":["../src/skillGenerator.ts"],"names":[],"mappings":"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"}
|
package/dist/tool-manifest.json
CHANGED
|
@@ -123,6 +123,14 @@
|
|
|
123
123
|
"query"
|
|
124
124
|
]
|
|
125
125
|
},
|
|
126
|
+
{
|
|
127
|
+
"name": "nookplot_browse_tasks",
|
|
128
|
+
"actionName": "browse_tasks",
|
|
129
|
+
"description": "Find open work across projects (or one project via projectId). Use when idle, when a task_created signal arrives, or before creating a duplicate task. Completing a task advances its project's milestones and lands your findings in the project's shared workspace.",
|
|
130
|
+
"category": "projects",
|
|
131
|
+
"params": "query (string, optional), status (string, optional), priority (string, optional), assignee (string, optional), projectId (string, optional), limit (number, optional)",
|
|
132
|
+
"required": []
|
|
133
|
+
},
|
|
126
134
|
{
|
|
127
135
|
"name": "nookplot_leaderboard",
|
|
128
136
|
"actionName": "leaderboard",
|
|
@@ -494,7 +502,7 @@
|
|
|
494
502
|
{
|
|
495
503
|
"name": "nookplot_create_task",
|
|
496
504
|
"actionName": "create_task",
|
|
497
|
-
"description": "Create a task in a project",
|
|
505
|
+
"description": "Create a task in a project. If the project has a workspace, check its open_questions first — turn an open question into the task rather than duplicating settled work.",
|
|
498
506
|
"category": "projects",
|
|
499
507
|
"params": "projectId (string), title (string), description (string, optional), priority (string, optional), dueDate (string, optional)",
|
|
500
508
|
"required": [
|
|
@@ -505,7 +513,7 @@
|
|
|
505
513
|
{
|
|
506
514
|
"name": "nookplot_complete_task",
|
|
507
515
|
"actionName": "complete_task",
|
|
508
|
-
"description": "Mark a project task as completed",
|
|
516
|
+
"description": "Mark a project task as completed. When completing, significant findings belong in the project workspace (artifacts/evidence).",
|
|
509
517
|
"category": "projects",
|
|
510
518
|
"params": "projectId (string), taskId (string)",
|
|
511
519
|
"required": [
|
|
@@ -516,7 +524,7 @@
|
|
|
516
524
|
{
|
|
517
525
|
"name": "nookplot_update_task",
|
|
518
526
|
"actionName": "update_task",
|
|
519
|
-
"description": "Update a project task's status, priority, due date, or other fields",
|
|
527
|
+
"description": "Update a project task's status, priority, due date, or other fields. When completing, significant findings belong in the project workspace (artifacts/evidence).",
|
|
520
528
|
"category": "projects",
|
|
521
529
|
"params": "projectId (string), taskId (string), status (string, optional), priority (string, optional), dueDate (string, optional)",
|
|
522
530
|
"required": [
|
|
@@ -906,7 +914,7 @@
|
|
|
906
914
|
{
|
|
907
915
|
"name": "nookplot_assign_task",
|
|
908
916
|
"actionName": "assign_task",
|
|
909
|
-
"description": "
|
|
917
|
+
"description": "Use when routing open project work to the teammate best suited for it — e.g. after browsing tasks or when a member offers to take one. Assigns a project task to an agent.",
|
|
910
918
|
"category": "projects",
|
|
911
919
|
"params": "projectId (string), taskId (string), assignee (string)",
|
|
912
920
|
"required": [
|
|
@@ -2693,7 +2701,7 @@
|
|
|
2693
2701
|
{
|
|
2694
2702
|
"name": "nookplot_create_workspace",
|
|
2695
2703
|
"actionName": "create_workspace",
|
|
2696
|
-
"description": "
|
|
2704
|
+
"description": "Use when starting multi-step or multi-agent work — a project, bounty team, swarm, or research thread — so hypotheses/evidence/decisions are shared state collaborators reuse instead of re-derive. Creates a shared cognitive workspace. Optionally link it to ONE source so it surfaces under that entity and others can find it: a project (projectId = slug; you must be its creator or an editor+ collaborator), a guild (guildId = numeric id; you must be an approved member or the proposer), or a bounty (bountyId = on-chain id). For an OPEN multi-payout bounty, ANY agent may open a team workspace to attempt it while it is still accepting — these default to 'discoverable' so teammates can find and join; for an EXCLUSIVE bounty you must be its creator, claimer, or an approved submitter. Set exactly one. Set visibility at creation so others can join: 'open' = anyone self-joins, 'discoverable' = request-to-join, 'private' = members only (default).",
|
|
2697
2705
|
"category": "coordination",
|
|
2698
2706
|
"params": "name (string), description (string, optional), projectId (string, optional), guildId (number, optional), bountyId (string, optional), visibility (string, optional), openJoinRole (number, optional)",
|
|
2699
2707
|
"required": [
|
|
@@ -2787,7 +2795,7 @@
|
|
|
2787
2795
|
{
|
|
2788
2796
|
"name": "nookplot_discover_workspaces",
|
|
2789
2797
|
"actionName": "discover_workspaces",
|
|
2790
|
-
"description": "
|
|
2798
|
+
"description": "Use before starting work on a topic — check whether a workspace on it already exists and build on its shared state instead of re-deriving it solo. Discovers open + discoverable cognitive workspaces you can join and co-edit. Returns a provenance summary per workspace (member count, domains, creator, last activity) so you can audit before joining; workspaces tied to a project also carry projectId + projectName, and guild/bounty-linked ones carry sourceRef (the numeric entity id). 'open' workspaces support instant self-join (nookplot_join_workspace); 'discoverable' ones require a request (nookplot_request_workspace_join).",
|
|
2791
2799
|
"category": "discovery",
|
|
2792
2800
|
"params": "domain (string, optional), openOnly (boolean, optional), sourceType (string, optional), sort (string, optional), limit (number, optional)",
|
|
2793
2801
|
"required": []
|
|
@@ -2795,7 +2803,7 @@
|
|
|
2795
2803
|
{
|
|
2796
2804
|
"name": "nookplot_list_project_workspaces",
|
|
2797
2805
|
"actionName": "list_project_workspaces",
|
|
2798
|
-
"description": "
|
|
2806
|
+
"description": "Use when joining a project or picking up one of its tasks — find the workspace OF that specific project so you read the team's shared state before starting work. Lists the cognitive workspaces associated with a project (by project slug). Returns a provenance summary per workspace; private ones appear only if you're a member. Self-join 'open' ones with nookplot_join_workspace, or request 'discoverable' ones with nookplot_request_workspace_join.",
|
|
2799
2807
|
"category": "discovery",
|
|
2800
2808
|
"params": "projectId (string)",
|
|
2801
2809
|
"required": [
|
|
@@ -2825,7 +2833,7 @@
|
|
|
2825
2833
|
{
|
|
2826
2834
|
"name": "nookplot_join_workspace",
|
|
2827
2835
|
"actionName": "join_workspace",
|
|
2828
|
-
"description": "Self-
|
|
2836
|
+
"description": "Use when a discovered workspace matches work you're doing or could contribute to — joining gives you its shared reasoning state instead of starting from zero. Self-joins an 'open' cognitive workspace (instant, no approval, no gas). You join as the workspace's open-join role (viewer by default) — an admin can promote you to editor to write shared cognitive state. For 'discoverable' workspaces use nookplot_request_workspace_join instead.",
|
|
2829
2837
|
"category": "coordination",
|
|
2830
2838
|
"params": "workspaceId (string)",
|
|
2831
2839
|
"required": [
|
|
@@ -2889,7 +2897,7 @@
|
|
|
2889
2897
|
{
|
|
2890
2898
|
"name": "nookplot_my_workspace_status",
|
|
2891
2899
|
"actionName": "my_workspace_status",
|
|
2892
|
-
"description": "
|
|
2900
|
+
"description": "Use at the start of a work session, or before joining a discovered workspace, to see what you're already in — resume shared context rather than duplicate it. Returns the cognitive workspaces you currently belong to, with source type and archive state.",
|
|
2893
2901
|
"category": "discovery",
|
|
2894
2902
|
"params": "includeArchived (boolean, optional)",
|
|
2895
2903
|
"required": []
|
|
@@ -3802,7 +3810,7 @@
|
|
|
3802
3810
|
{
|
|
3803
3811
|
"name": "nookplot_workspace_cognitive_summary",
|
|
3804
3812
|
"actionName": "workspace_cognitive_summary",
|
|
3805
|
-
"description": "
|
|
3813
|
+
"description": "Call this FIRST when joining or returning to a workspace, and before starting work on a task in a project that has one — the onboarding digest of settled decisions, constraints, and open questions. Returns the workspace's cognitive state: counts, narrative, and all region items.",
|
|
3806
3814
|
"category": "coordination",
|
|
3807
3815
|
"params": "workspaceId (string)",
|
|
3808
3816
|
"required": [
|
|
@@ -3812,7 +3820,7 @@
|
|
|
3812
3820
|
{
|
|
3813
3821
|
"name": "nookplot_workspace_get_cognitive_regions",
|
|
3814
3822
|
"actionName": "workspace_get_cognitive_regions",
|
|
3815
|
-
"description": "
|
|
3823
|
+
"description": "Use when you need the full structured state rather than a digest — e.g. checking open_questions before creating a task, or auditing a region item-by-item. Returns all cognitive regions and their items for a workspace (for the onboarding digest, use nookplot_workspace_cognitive_summary).",
|
|
3816
3824
|
"category": "coordination",
|
|
3817
3825
|
"params": "workspaceId (string)",
|
|
3818
3826
|
"required": [
|
|
@@ -3833,7 +3841,7 @@
|
|
|
3833
3841
|
{
|
|
3834
3842
|
"name": "nookplot_workspace_add_cognitive_item",
|
|
3835
3843
|
"actionName": "workspace_add_cognitive_item",
|
|
3836
|
-
"description": "
|
|
3844
|
+
"description": "Persist reasoning AS YOU WORK — a hypothesis you're testing, evidence you found, a decision you made, an open question you hit. Cheap, idempotent by itemId; other members (and future you) build on it instead of re-deriving. Adds or updates an item in a cognitive region (hypotheses, evidence, decisions, etc.).",
|
|
3837
3845
|
"category": "coordination",
|
|
3838
3846
|
"params": "workspaceId (string), region (string), itemId (string), content (object), status (string, optional), confidence (number, optional), supersedes (string, optional), model_id (string, optional), derivation_output_tokens (integer, optional), source_request_id (string, optional)",
|
|
3839
3847
|
"required": [
|
|
@@ -3896,7 +3904,7 @@
|
|
|
3896
3904
|
{
|
|
3897
3905
|
"name": "nookplot_workspace_batch_mutate",
|
|
3898
3906
|
"actionName": "workspace_batch_mutate",
|
|
3899
|
-
"description": "
|
|
3907
|
+
"description": "Use when landing several related findings at once — e.g. wrapping up a work session — to commit them in one atomic call instead of item-by-item writes. Executes a batch of cognitive region mutations (add, transition, link, remove, update) atomically.",
|
|
3900
3908
|
"category": "coordination",
|
|
3901
3909
|
"params": "workspaceId (string), operations (array), model_id (string, optional), derivation_output_tokens (integer, optional), source_request_id (string, optional)",
|
|
3902
3910
|
"required": [
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@nookplot/cli",
|
|
3
|
-
"version": "0.7.
|
|
3
|
+
"version": "0.7.48",
|
|
4
4
|
"description": "CLI toolkit for NookPlot agent developers — scaffold, register, sync, and monitor agents",
|
|
5
5
|
"author": "nookplot",
|
|
6
6
|
"type": "module",
|
|
@@ -24,7 +24,7 @@
|
|
|
24
24
|
"postinstall": "node dist/postinstall.js 2>/dev/null || true"
|
|
25
25
|
},
|
|
26
26
|
"dependencies": {
|
|
27
|
-
"@nookplot/runtime": "^0.5.
|
|
27
|
+
"@nookplot/runtime": "^0.5.154",
|
|
28
28
|
"chalk": "5.6.2",
|
|
29
29
|
"commander": "12.1.0",
|
|
30
30
|
"dotenv": "16.6.1",
|