coaiajs 0.4.3 → 0.5.1

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.
Files changed (78) hide show
  1. package/README.md +24 -5
  2. package/dist/mcp/config.d.ts.map +1 -1
  3. package/dist/mcp/config.js +13 -1
  4. package/dist/mcp/config.js.map +1 -1
  5. package/dist/mcp/server.js +11 -1
  6. package/dist/mcp/server.js.map +1 -1
  7. package/dist/src/cli.js +62 -2
  8. package/dist/src/cli.js.map +1 -1
  9. package/dist/src/index.d.ts +1 -0
  10. package/dist/src/index.d.ts.map +1 -1
  11. package/dist/src/index.js +1 -0
  12. package/dist/src/index.js.map +1 -1
  13. package/dist/src/narrative/argument-hygiene.d.ts +46 -0
  14. package/dist/src/narrative/argument-hygiene.d.ts.map +1 -0
  15. package/dist/src/narrative/argument-hygiene.js +155 -0
  16. package/dist/src/narrative/argument-hygiene.js.map +1 -0
  17. package/dist/src/narrative/contract.d.ts +200 -0
  18. package/dist/src/narrative/contract.d.ts.map +1 -0
  19. package/dist/src/narrative/contract.js +274 -0
  20. package/dist/src/narrative/contract.js.map +1 -0
  21. package/dist/src/narrative/github-bridge.d.ts +23 -0
  22. package/dist/src/narrative/github-bridge.d.ts.map +1 -0
  23. package/dist/src/narrative/github-bridge.js +320 -0
  24. package/dist/src/narrative/github-bridge.js.map +1 -0
  25. package/dist/src/narrative/graph-manager.d.ts +83 -2
  26. package/dist/src/narrative/graph-manager.d.ts.map +1 -1
  27. package/dist/src/narrative/graph-manager.js +444 -54
  28. package/dist/src/narrative/graph-manager.js.map +1 -1
  29. package/dist/src/narrative/index.d.ts +24 -3
  30. package/dist/src/narrative/index.d.ts.map +1 -1
  31. package/dist/src/narrative/index.js +36 -15
  32. package/dist/src/narrative/index.js.map +1 -1
  33. package/dist/src/narrative/jsonl-preservation.d.ts +26 -0
  34. package/dist/src/narrative/jsonl-preservation.d.ts.map +1 -0
  35. package/dist/src/narrative/jsonl-preservation.js +293 -0
  36. package/dist/src/narrative/jsonl-preservation.js.map +1 -0
  37. package/dist/src/narrative/jsonl-records.d.ts +31 -0
  38. package/dist/src/narrative/jsonl-records.d.ts.map +1 -0
  39. package/dist/src/narrative/jsonl-records.js +69 -0
  40. package/dist/src/narrative/jsonl-records.js.map +1 -0
  41. package/dist/src/narrative/tool-definitions.d.ts +2 -1
  42. package/dist/src/narrative/tool-definitions.d.ts.map +1 -1
  43. package/dist/src/narrative/tool-definitions.js +134 -1
  44. package/dist/src/narrative/tool-definitions.js.map +1 -1
  45. package/dist/src/narrative/tool-handlers.d.ts.map +1 -1
  46. package/dist/src/narrative/tool-handlers.js +203 -20
  47. package/dist/src/narrative/tool-handlers.js.map +1 -1
  48. package/dist/src/narrative/types.d.ts +1 -1
  49. package/dist/src/narrative/types.d.ts.map +1 -1
  50. package/dist/src/narrative/validation.d.ts +13 -2
  51. package/dist/src/narrative/validation.d.ts.map +1 -1
  52. package/dist/src/narrative/validation.js +19 -4
  53. package/dist/src/narrative/validation.js.map +1 -1
  54. package/dist/src/skill.d.ts +78 -0
  55. package/dist/src/skill.d.ts.map +1 -0
  56. package/dist/src/skill.js +341 -0
  57. package/dist/src/skill.js.map +1 -0
  58. package/dist/src/types.d.ts +189 -0
  59. package/dist/src/types.d.ts.map +1 -1
  60. package/dist/src/types.js.map +1 -1
  61. package/dist/src/version.d.ts +9 -0
  62. package/dist/src/version.d.ts.map +1 -1
  63. package/dist/src/version.js +30 -14
  64. package/dist/src/version.js.map +1 -1
  65. package/docs/LINEAGE-COAIA-NARRATIVE.md +150 -0
  66. package/llms-full.txt +93 -8
  67. package/llms.txt +6 -3
  68. package/package.json +11 -1
  69. package/skills/coaiajs/SKILL.md +151 -0
  70. package/skills/coaiajs/references/beyond-narrative.md +82 -0
  71. package/skills/coaiajs/references/creative-orientation.md +42 -0
  72. package/skills/coaiajs/references/delayed-resolution.md +48 -0
  73. package/skills/coaiajs/references/install-and-environment.md +85 -0
  74. package/skills/coaiajs/references/mcp-tools.md +83 -0
  75. package/skills/coaiajs/references/narrative-beats.md +44 -0
  76. package/skills/coaiajs/references/reading-the-store.md +66 -0
  77. package/skills/coaiajs/references/structural-tension-charting.md +71 -0
  78. package/skills/coaiajs/references/wampum-belts.md +72 -0
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,qEAAqE;AAuKrE,MAAM,CAAC,MAAM,YAAY,GAA2B;IAClD,SAAS,EAAE,CAAC;IACZ,OAAO,EAAE,CAAC;IACV,UAAU,EAAE,EAAE;CACf,CAAC"}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,qEAAqE;AAsYrE,MAAM,CAAC,MAAM,YAAY,GAA2B;IAClD,SAAS,EAAE,CAAC;IACZ,OAAO,EAAE,CAAC;IACV,UAAU,EAAE,EAAE;CACf,CAAC"}
@@ -1,3 +1,12 @@
1
+ /**
2
+ * Directory holding this package's own `package.json`.
3
+ *
4
+ * Anything shipped alongside `dist/` — the packaged skill under `skills/`, the
5
+ * Custom GPT specs, the rispecs — is found from here rather than from
6
+ * `process.cwd()`, which is the caller's directory and says nothing about where
7
+ * the package was installed.
8
+ */
9
+ export declare function getPackageRoot(): string;
1
10
  /** Resolved version of the installed `coaiajs` package. */
2
11
  export declare function getPackageVersion(): string;
3
12
  //# sourceMappingURL=version.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAYA,2DAA2D;AAC3D,wBAAgB,iBAAiB,IAAI,MAAM,CAyB1C"}
1
+ {"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAaA;;;;;;;GAOG;AACH,wBAAgB,cAAc,IAAI,MAAM,CA0BvC;AAED,2DAA2D;AAC3D,wBAAgB,iBAAiB,IAAI,MAAM,CAI1C"}
@@ -1,33 +1,49 @@
1
- // coaiajs/src/version.ts — single source of truth for the runtime version.
2
- // Reads package.json at runtime so the CLI banner, the MCP handshake, and the
3
- // published package can never drift apart again.
1
+ // coaiajs/src/version.ts — single source of truth for the runtime version and the
2
+ // installed package root. Reads package.json at runtime so the CLI banner, the MCP
3
+ // handshake, the packaged skill, and the published package can never drift apart.
4
4
  import { readFileSync } from 'node:fs';
5
5
  import { dirname, join } from 'node:path';
6
6
  import { fileURLToPath } from 'node:url';
7
7
  const PACKAGE_NAME = 'coaiajs';
8
- let cached;
9
- /** Resolved version of the installed `coaiajs` package. */
10
- export function getPackageVersion() {
11
- if (cached)
12
- return cached;
8
+ let cachedVersion;
9
+ let cachedRoot;
10
+ /**
11
+ * Directory holding this package's own `package.json`.
12
+ *
13
+ * Anything shipped alongside `dist/` — the packaged skill under `skills/`, the
14
+ * Custom GPT specs, the rispecs — is found from here rather than from
15
+ * `process.cwd()`, which is the caller's directory and says nothing about where
16
+ * the package was installed.
17
+ */
18
+ export function getPackageRoot() {
19
+ if (cachedRoot)
20
+ return cachedRoot;
13
21
  const here = dirname(fileURLToPath(import.meta.url));
14
22
  // dist/src/version.js -> package root is two levels up.
15
23
  // src/version.ts (ts-node/tsx) -> package root is one level up.
16
- const candidates = [join(here, '..', '..', 'package.json'), join(here, '..', 'package.json')];
17
- for (const candidate of candidates) {
24
+ const candidates = [join(here, '..', '..'), join(here, '..')];
25
+ for (const root of candidates) {
18
26
  let raw;
19
27
  try {
20
- raw = readFileSync(candidate, 'utf8');
28
+ raw = readFileSync(join(root, 'package.json'), 'utf8');
21
29
  }
22
30
  catch {
23
31
  continue; // not at this depth; try the next candidate
24
32
  }
25
33
  const pkg = JSON.parse(raw);
26
34
  if (pkg.name === PACKAGE_NAME && pkg.version) {
27
- cached = pkg.version;
28
- return cached;
35
+ cachedRoot = root;
36
+ cachedVersion = pkg.version;
37
+ return cachedRoot;
29
38
  }
30
39
  }
31
- throw new Error(`Unable to resolve ${PACKAGE_NAME} version: no package.json found near ${here}`);
40
+ throw new Error(`Unable to resolve the ${PACKAGE_NAME} package root: no matching package.json near ${here}`);
41
+ }
42
+ /** Resolved version of the installed `coaiajs` package. */
43
+ export function getPackageVersion() {
44
+ if (cachedVersion)
45
+ return cachedVersion;
46
+ getPackageRoot(); // populates cachedVersion, or throws naming the reason
47
+ return cachedVersion;
32
48
  }
33
49
  //# sourceMappingURL=version.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,8EAA8E;AAC9E,iDAAiD;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,YAAY,GAAG,SAAS,CAAC;AAE/B,IAAI,MAA0B,CAAC;AAE/B,2DAA2D;AAC3D,MAAM,UAAU,iBAAiB;IAC/B,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,wDAAwD;IACxD,gEAAgE;IAChE,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC;IAE9F,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,GAAG,GAAG,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,SAAS,CAAC,4CAA4C;QACxD,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAwC,CAAC;QACnE,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAC7C,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC;YACrB,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CACb,qBAAqB,YAAY,wCAAwC,IAAI,EAAE,CAChF,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,mFAAmF;AACnF,kFAAkF;AAElF,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,YAAY,GAAG,SAAS,CAAC;AAE/B,IAAI,aAAiC,CAAC;AACtC,IAAI,UAA8B,CAAC;AAEnC;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAElC,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,wDAAwD;IACxD,gEAAgE;IAChE,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAE9D,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,SAAS,CAAC,4CAA4C;QACxD,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAwC,CAAC;QACnE,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAC7C,UAAU,GAAG,IAAI,CAAC;YAClB,aAAa,GAAG,GAAG,CAAC,OAAO,CAAC;YAC5B,OAAO,UAAU,CAAC;QACpB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CACb,yBAAyB,YAAY,gDAAgD,IAAI,EAAE,CAC5F,CAAC;AACJ,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,iBAAiB;IAC/B,IAAI,aAAa;QAAE,OAAO,aAAa,CAAC;IACxC,cAAc,EAAE,CAAC,CAAC,uDAAuD;IACzE,OAAO,aAAuB,CAAC;AACjC,CAAC"}
@@ -0,0 +1,150 @@
1
+ # Lineage: coaia-narrative → coaiajs
2
+
3
+ ## What the relationship is
4
+
5
+ `coaiajs` is the package we maintain. `avadisabelle/coaia-narrative` is where several of
6
+ these ideas were first built and several of these bugs were first paid for.
7
+
8
+ That makes this a **one-way port, not a mirror**. We read that repository for corrections
9
+ worth carrying, we decide what shape they take here, and we own the result. Nothing in
10
+ this package is expected to stay byte-identical to anything over there, and a future
11
+ instance should not treat a difference as drift to be undone.
12
+
13
+ The direction never reverses. We do not push changes back, and we do not wait on that
14
+ repository before fixing something here.
15
+
16
+ ## Ported through
17
+
18
+ | | |
19
+ |---|---|
20
+ | Upstream repo | `avadisabelle/coaia-narrative` (`git@github.com:avadisabelle/coaia-narrative.git`) |
21
+ | Original snapshot taken at | `12c60f8` (2026-03-08) — landed here as `d6a544e`, 2026-03-11 |
22
+ | **Ported through** | **`68f6e2f`** — merge of PR #55, upstream v0.16.2, 2026-08-11 |
23
+ | Landed here as | `03658fa` (narrative parity) and the commit adding this file |
24
+ | Tracking issue | jgwill/coaiajs#13 |
25
+
26
+ **Update the "Ported through" row in the same commit that lands the next port.** It is the
27
+ only record of where the last one stopped, and a port that does not update it costs the
28
+ next instance the whole diff again.
29
+
30
+ ## How to find the next port
31
+
32
+ ```bash
33
+ UPSTREAM=/path/to/coaia-narrative # or: git clone git@github.com:avadisabelle/coaia-narrative.git
34
+ PORTED_THROUGH=68f6e2f
35
+
36
+ cd "$UPSTREAM" && git fetch --all
37
+
38
+ # What changed in code since we last looked
39
+ git diff --stat "$PORTED_THROUGH..origin/main" -- '*.ts'
40
+
41
+ # Release-shaped commits carry their reason in the subject line — read these first,
42
+ # they are usually one measured failure each
43
+ git log --oneline "$PORTED_THROUGH..origin/main"
44
+
45
+ # The full text of one change, with its comments, which is where the reasoning lives
46
+ git show <sha>
47
+ ```
48
+
49
+ Upstream writes its commit subjects as the failure that was found, not as the change that
50
+ was made ("a --memory-path carrying an unexpanded shell variable is refused"). Read the
51
+ subject lines before the diff — they tell you which changes carry a real finding and which
52
+ are packaging.
53
+
54
+ ## How to port
55
+
56
+ The two trees are not diff-compatible. When the March snapshot was taken it was
57
+ reformatted (single quotes, trailing commas, prettier widths), types were moved to
58
+ `src/types.ts`, and `LLM_GUIDANCE` was inlined. `git apply` will not work and should not
59
+ be attempted. Port **semantically**: read the upstream change, understand the finding
60
+ behind it, then write it here in this codebase's shape.
61
+
62
+ Rules that have held so far:
63
+
64
+ 1. **Carry the reasoning, not just the code.** Upstream comments name the date, the
65
+ measurement, and the cost of the bug. Those comments are the most valuable part of the
66
+ change — a future reader who does not know why a guard exists will delete it. Rewrite
67
+ them for this package's context rather than dropping them.
68
+ 2. **Adapt anything that names the other package.** Binary names, MCP server names,
69
+ environment variables, and example issue references all differ. A copy that still says
70
+ `cnarrative` or `COAIA_TOOLS` is wrong here even if it compiles.
71
+ 3. **Put the change where this codebase already puts that kind of thing.** Shared types go
72
+ in `src/types.ts`, not a per-module types file. The memory-path guard belongs in the
73
+ `KnowledgeGraphManager` constructor here, because that covers the CLI, the MCP server,
74
+ and library consumers at once — upstream put it in its single entry point because that
75
+ is all it has.
76
+ 4. **Write a test per finding.** `tests/narrative-parity.test.js` is organised as one
77
+ `describe` per finding, named for the behaviour it holds. A ported correction with no
78
+ test is a correction that will be un-ported by the next refactor.
79
+ 5. **Update the docs in the same commit.** `test/docs.test.mjs` fails the build when
80
+ `README.md` / `llms.txt` / `llms-full.txt` disagree with the served tool surface, so
81
+ this is enforced, not optional.
82
+
83
+ ## What has been adapted rather than copied
84
+
85
+ ### The skill (`src/skill.ts`, `skills/coaiajs/`)
86
+
87
+ Upstream ships `cnarrative skill show|install`. We ship `coaia skill show|install|check`.
88
+ Four deliberate differences:
89
+
90
+ | | upstream | here | why |
91
+ |---|---|---|---|
92
+ | Content location | ~250 lines of markdown as a TypeScript string array | real `.md` files under `skills/coaiajs/`, shipped via `files` | a doc change should read as a doc diff, and markdown tooling should be able to see it |
93
+ | Tool map | hand-written table | generated from `ALL_TOOL_DEFINITIONS` at render time | a hand-written map advertises tools the server does not serve the moment one is added |
94
+ | Subject | `coaia-narrative`, `cnarrative`, `COAIA_TOOLS` | `coaiajs`, `coaia`, `coaiajs-mcp`, `COAIAJS_FEATURES` | it has to describe the surface it actually installs next to |
95
+ | Staleness | not detectable | `coaia skill check`, plus `packageVersion` in the installed frontmatter | a skill installed by an older version describes an older surface and nothing else says so |
96
+
97
+ The reference set is also larger, because this package has more surface: `wampum-belts.md`,
98
+ `reading-the-store.md`, and `beyond-narrative.md` (PDE, planning, Langfuse, pipeline) have
99
+ no upstream counterpart.
100
+
101
+ **If upstream changes its skill content, do not copy the change in.** Read what it learned
102
+ and decide whether it applies to our surface. These are two skills describing two packages.
103
+
104
+ ### The read contract subpath
105
+
106
+ Upstream publishes `coaia-narrative/contract` because its package root **is** the MCP
107
+ server bootstrap — importing it starts a stdio server, so a renderer must have a separate
108
+ door. Our root is a plain library and has no such hazard. We publish
109
+ `coaiajs/narrative/contract` anyway, because the other reason holds: a renderer should be
110
+ able to pull the store's shape without pulling the whole package.
111
+
112
+ ## Deliberately not ported
113
+
114
+ | Upstream | Why not |
115
+ |---|---|
116
+ | `index.ts` / `cli.ts` entry points | We have our own, with a different command surface and argument style |
117
+ | `generated-llm-guidance.ts` | Inlined here as `LLM_GUIDANCE_FULL` / `_QUICK` / `_SAVE_DIRECTIVE` in `src/narrative/tool-handlers.ts` |
118
+ | `src/help.ts`, `src/tool-groups.ts` | Commander provides help; the groups live in `src/narrative/tool-definitions.ts` |
119
+ | `handlers/` (push, issues, ceremony, story-engine) | Webhook event handlers for that repo's deployment, not library capability |
120
+ | `types.ts`'s `Direction = 'EAST' \| 'SOUTH' \| ...` | Unused upstream, and the name is already taken here by the PDE lowercase direction type |
121
+ | `scripts/check-schema-parity.cjs` | Bound to that repo's `schema/` fixtures |
122
+
123
+ Revisit any of these if the reason stops being true. Record the decision here when you do.
124
+
125
+ ## Where this package is deliberately ahead or different
126
+
127
+ Do not "correct" these back toward upstream:
128
+
129
+ - **`setDueDate` goes through `updateChartDueDate`.** It used to re-serialise the store by
130
+ hand with `writeFileSync`, which ignored `--memory-path` and dropped unmodelled fields.
131
+ - **The memory-path guard is in the constructor**, so it covers library consumers, not only
132
+ a CLI entry point.
133
+ - **`mcp/server.ts` catches that guard** and exits 1 with a one-line refusal rather than an
134
+ unhandled throw.
135
+ - **`src/version.ts` exports `getPackageRoot()`**, which is how anything shipped beside
136
+ `dist/` (the skill, the Custom GPT specs) is located. Do not reach for `process.cwd()`.
137
+ - **Tool counts in the docs are enforced by `test/docs.test.mjs`.** Upstream has no
138
+ equivalent; do not relax ours to match.
139
+
140
+ ## Checklist for the next port
141
+
142
+ - [ ] `git log --oneline <PORTED_THROUGH>..origin/main` in the upstream checkout; read the subjects
143
+ - [ ] `git diff --stat <PORTED_THROUGH>..origin/main -- '*.ts'`
144
+ - [ ] For each change: is it a finding, packaging, or entry-point specific?
145
+ - [ ] Port the findings semantically, carrying their reasoning as comments
146
+ - [ ] One `describe` block per finding in `tests/narrative-parity.test.js`
147
+ - [ ] `npm run build && npm test` — the docs suite will catch a stale tool count
148
+ - [ ] `coaia skill check` after a local install, if the tool surface changed
149
+ - [ ] Update **Ported through** above, and the "not ported" table if a decision changed
150
+ - [ ] Bump the version, publish, and note the upstream range in the commit body
package/llms-full.txt CHANGED
@@ -110,19 +110,31 @@ EnvironmentManager, createEnvironment, findEnvironment
110
110
 
111
111
  ```
112
112
  getPackageVersion
113
+ getPackageRoot
113
114
  ```
114
115
 
115
- Returns the resolved version of the installed package, read from `package.json` at runtime.
116
+ `getPackageVersion` returns the resolved version of the installed package, read from `package.json` at runtime. `getPackageRoot` returns the directory holding that `package.json` — the way anything shipped beside `dist/` (the packaged skill under `skills/`, the Custom GPT specs) is located. Do not use `process.cwd()` for that; it is the caller's directory and says nothing about where the package was installed.
116
117
 
117
118
  ### `coaiajs/narrative`
118
119
 
119
120
  ```
120
- KnowledgeGraphManager, ValidationSchemas, validate,
121
- addAction, completeAction, addObservation, setDueDate, setCurrentChart, getCurrentChart,
121
+ KnowledgeGraphManager, parseGithubIssueSpec, ValidationSchemas, validate,
122
+ addAction, completeAction, addObservation, setDueDate, linkGithubIssue,
123
+ setCurrentChart, getCurrentChart,
122
124
  updateChart, viewChart, listCharts, getProgress, getStats, performMmot,
123
125
  exportChart, exportAllCharts, exportChartToMarkdown, exportAllChartsToMarkdown,
124
126
  exportChartProgress, exportChartStats, writeMarkdownToFile, getDefaultFilename,
125
- handleToolCall, ALL_TOOL_DEFINITIONS, CORE_TOOLS, KG_TOOLS, NARRATIVE_TOOLS, STC_TOOLS
127
+ handleToolCall, ALL_TOOL_DEFINITIONS, CORE_TOOLS, KG_TOOLS, NARRATIVE_TOOLS,
128
+ STC_TOOLS, WAMPUM_TOOLS,
129
+ parseJsonlMemory, serializeJsonlMemory, readJsonlMemoryFile, writeJsonlMemoryFile,
130
+ isObject, isEntityRecord, isLegacyNarrativeBeatRecord, isRelationRecord,
131
+ normalizeLegacyNarrativeBeat,
132
+ findUnparsedCallSyntax, findUnparsedCallSyntaxIn, describeUnparsedCallSyntax,
133
+ assertNoUnparsedCallSyntax, KNOWN_ARGUMENT_NAMES,
134
+ GITHUB_PROJECT_FIELD_NAMES, normalizeGithubBridgeMetadata,
135
+ createGithubProjectFieldProjection, projectEntityToGithubFields,
136
+ deriveGithubProjectStatus, getGithubIssueUrl,
137
+ contract
126
138
  ```
127
139
 
128
140
  ```typescript
@@ -131,6 +143,58 @@ const kg = new KnowledgeGraphManager('./memory.jsonl');
131
143
  const graph = await kg.readGraph();
132
144
  ```
133
145
 
146
+ The store is read and written through `jsonl-preservation`: a line's fields that this
147
+ package does not model survive a write, the legacy top-level `type:"narrative_beat"`
148
+ dialect round-trips as itself, and the write is temp-file-plus-rename so a concurrent
149
+ reader never sees a truncated store.
150
+
151
+ A memory path still carrying an unexpanded shell variable (`${VAR}`) is refused by the
152
+ constructor rather than opened. The failure it prevents is silent: the store is created
153
+ under that literal name, or — worse, if the variable pointed at a path that does not
154
+ exist — the process starts clean and empty and the caller reports their charts lost.
155
+
156
+ ### `coaiajs/narrative/contract`
157
+
158
+ The read contract for renderers: zero I/O, no import of the server, tolerant of one bad
159
+ line where the writer's parser is deliberately not. Use it to read a chart store without
160
+ re-deriving entity kinds, the `${chartId}_chart` naming scheme, or which metadata key
161
+ holds the MMOT trail.
162
+
163
+ ```
164
+ CONTRACT_VERSION, ENTITY_TYPES, MMOT_PHASES, CREATING_PHASES, isMmotPhase,
165
+ parseStore, chartEntityName, desiredOutcomeName, currentRealityName,
166
+ mmotBeatPrefix, isMmotBeatName, metaString, isComplete,
167
+ getChartEntity, getDesiredOutcome, getCurrentReality,
168
+ getFlatActionSteps, getChildCharts, getWork, getMmotBeats, getMmotEvaluations,
169
+ storeRevision, revisionOf
170
+ ```
171
+
172
+ ```typescript
173
+ import { parseStore, getWork } from 'coaiajs/narrative/contract';
174
+ const store = parseStore(await readFile('./memory.jsonl', 'utf8'));
175
+ const work = getWork(store, 'chart_1757200000000');
176
+ ```
177
+
178
+ ### `coaiajs/skill`
179
+
180
+ The agent skill this package ships, describing its own surface.
181
+
182
+ ```
183
+ SKILL_NAME, SKILL_FILES, getPackagedSkillDir,
184
+ renderSkill, renderSkillFile, renderToolMap,
185
+ showSkill, installSkill, checkSkill, formatSkillCheck,
186
+ getSkillInstallDir, getClaudeSkillLinkPath
187
+ ```
188
+
189
+ ```bash
190
+ coaia skill show # print the packaged SKILL.md, rendered
191
+ coaia skill install --yes # ./.agents/skills/coaiajs + the .claude/skills symlink
192
+ coaia skill install --global # ~/.agents/skills/coaiajs
193
+ coaia skill check # current / stale / missing; exits non-zero unless current
194
+ ```
195
+
196
+ The content lives as real markdown under `skills/coaiajs/` rather than as strings in the TypeScript, so a documentation change reads as a documentation diff. The `{{TOOL_MAP}}` placeholder inside `SKILL.md` is rendered from `ALL_TOOL_DEFINITIONS` — the same array the MCP server registers — so an installed skill cannot advertise a tool the server does not serve. The version it was rendered from is recorded in the installed frontmatter as `packageVersion`, which is what `checkSkill` reads.
197
+
134
198
  ### `coaiajs/pde`
135
199
 
136
200
  ```
@@ -202,7 +266,7 @@ PipelineVariable, PipelineStep, PipelineTemplate, CoaiaConfig
202
266
  npx coaiajs-mcp
203
267
  ```
204
268
 
205
- Transport: **stdio**. Serves **62 tools, 3 prompts, 1 listable resource**.
269
+ Transport: **stdio**. Serves **67 tools, 3 prompts, 1 listable resource**.
206
270
 
207
271
  Flags: `--memory-path <path>` (JSONL knowledge graph), `--plans-dir <path>`, `--feature-level <level>`.
208
272
 
@@ -223,7 +287,7 @@ Claude Code / client registration:
223
287
  | Level | Effect |
224
288
  |---|---|
225
289
  | `MINIMAL` | Core tash/fetch and essential graph tools |
226
- | `STANDARD` | Default — the 62 tools listed below |
290
+ | `STANDARD` | Default — the 67 tools listed below |
227
291
  | `OBSERVABILITY` | Same set as `STANDARD` |
228
292
  | `FULL` | Everything, including media tools |
229
293
 
@@ -240,7 +304,7 @@ coaia_fuse_score_configs_list, coaia_fuse_score_configs_get, coaia_fuse_score_ap
240
304
  coaia_fuse_comments_list, coaia_fuse_comments_get, coaia_fuse_comments_create
241
305
  ```
242
306
 
243
- ### Tools — narrative / knowledge graph (27)
307
+ ### Tools — narrative / knowledge graph (32)
244
308
 
245
309
  ```
246
310
  create_entities, create_relations, add_observations,
@@ -250,11 +314,26 @@ create_structural_tension_chart, manage_action_step, add_action_step,
250
314
  telescope_action_step, remove_action_step, mark_action_complete,
251
315
  get_chart_progress, list_active_charts, get_chart, get_action_step,
252
316
  update_action_progress, update_current_reality, update_desired_outcome,
317
+ update_chart_due_date, link_chart_to_github_issue,
253
318
  perform_mmot_evaluation,
254
319
  create_narrative_beat, telescope_narrative_beat, list_narrative_beats,
320
+ create_wampum_belt, add_wampum_bead, read_wampum_belt,
255
321
  init_llm_guidance
256
322
  ```
257
323
 
324
+ `update_chart_due_date` moves a chart and its desired outcome together; open action
325
+ steps keep their own dates unless `redistributeActionSteps` is true, and the count
326
+ still falling after the new date is reported either way.
327
+
328
+ `link_chart_to_github_issue` and the `githubIssue` argument on
329
+ `create_structural_tension_chart` take the FULL `owner/repo#number` path. A bare
330
+ `#number` is refused: charts travel between repositories, and a bare number cites
331
+ the wrong project as soon as the chart is read elsewhere.
332
+
333
+ The three `wampum_*` tools hold a non-linear mnemonic grid that runs in parallel with
334
+ the linear narrative beats. A bead carries a mnemonic, a canonical reading, optional
335
+ position-specific readings, and an optional ceremony link to a chart or a beat.
336
+
258
337
  ### Tools — PDE (10)
259
338
 
260
339
  ```
@@ -309,6 +388,7 @@ Global options: `--env <path>` · `-M, --memory-path <path>` · `--json` · `--n
309
388
  | `p <tag> [text]` | | Process text with a custom tag |
310
389
  | `init` | | Create a sample `coaia.json` |
311
390
  | `fuse` | | Langfuse operations |
391
+ | `skill` | | The packaged agent skill: show, install, check |
312
392
  | `narrative` | `n` | Structural tension chart operations |
313
393
  | `pde` | | Prompt Decomposition Engine |
314
394
  | `plan` | | Structural tension plan operations |
@@ -319,7 +399,8 @@ Global options: `--env <path>` · `-M, --memory-path <path>` · `--json` · `--n
319
399
  Subcommands:
320
400
 
321
401
  - **`fuse`** — `traces`, `prompts`, `datasets`, `sessions`, `scores` (`sc`), `score-configs` (`scc`), `comments`, `media`, `dataset-items`, `projects`
322
- - **`narrative`** — `list` (`ls`), `view` (`v`), `current` (`cur`), `update` (`up`), `add-action` (`aa`), `add-obs` (`ao`), `complete` (`done`), `export` (`exp`), `export-all`, `stats` (`st`), `progress` (`pg`), `mmot`, `set-date` (`sd`)
402
+ - **`skill`** — `show`, `install` (`--global`, `--yes`, `--force`), `check` (`--global`)
403
+ - **`narrative`** — `list` (`ls`), `view` (`v`), `current` (`cur`), `update` (`up`), `add-action` (`aa`), `add-obs` (`ao`), `complete` (`done`), `export` (`exp`), `export-all`, `stats` (`st`), `progress` (`pg`), `mmot`, `set-date` (`sd`, `--redistribute`), `link-issue`
323
404
  - **`pde`** — `import <pdeId>`, `list`, `sessions`, `show <sessionId>`
324
405
  - **`plan`** — `parse <planPath>`, `convert <planPath>`, `sync-to-chart <planPath> <chartsPath>`, `sync-to-plan <chartsPath> <planPath>`
325
406
  - **`pipeline`** — `list`, `show <name>`, `create <name>`, `init <name>`
@@ -370,3 +451,7 @@ npm run dev # tsc --watch
370
451
  Conventions: ESM only, relative imports end in `.js` · `strict: true`, no unjustified `any` · shared types live in `src/types.ts` · clients lazy, each module exports `resetClient()` · no side effects at import time.
371
452
 
372
453
  Per-module RISE specifications live in `rispecs/`, one file per module.
454
+
455
+ ### Carrying corrections forward from coaia-narrative
456
+
457
+ `src/narrative/` began as a snapshot of `avadisabelle/coaia-narrative` and still takes corrections from it — one way. `docs/LINEAGE-COAIA-NARRATIVE.md` records where the last port stopped (upstream `68f6e2f`, v0.16.2), how to compute the next diff, what was adapted rather than copied and why, and what is deliberately not ported. Read it before porting anything from that repository. The two trees are not diff-compatible; port semantically and carry the reasoning, not just the code.
package/llms.txt CHANGED
@@ -1,6 +1,6 @@
1
1
  # coaiajs
2
2
 
3
- > TypeScript package consolidating the CoAIA (Creative Orientation AI Architecture) ecosystem into one installable unit: a **library**, a **CLI** (`coaia`), and an **MCP server** (`coaiajs-mcp`, 62 tools). Its core data model is the *structural tension chart* — desired outcome, current reality, and telescoping action steps — backed by a JSONL knowledge graph.
3
+ > TypeScript package consolidating the CoAIA (Creative Orientation AI Architecture) ecosystem into one installable unit: a **library**, a **CLI** (`coaia`), and an **MCP server** (`coaiajs-mcp`, 67 tools). Its core data model is the *structural tension chart* — desired outcome, current reality, and telescoping action steps — backed by a JSONL knowledge graph.
4
4
 
5
5
  Install with `npm install coaiajs`. Requires Node.js >= 20. **ESM only** — there is no CommonJS build, so `require('coaiajs')` will not work. Ships `.d.ts` for every entry point.
6
6
 
@@ -9,7 +9,7 @@ Key facts an agent usually needs first:
9
9
  - Import from `coaiajs` (root) or a subpath such as `coaiajs/narrative`. **Do not** import `coaiajs/src/*.js` — `src/` is not shipped in the published package.
10
10
  - Clients (Redis, OpenAI, Polly, Octokit) are lazy: importing a module opens no connection and reads no file. Call `disconnect()` when finished.
11
11
  - Config precedence: environment variables > `.env` files > `coaia.json` > defaults.
12
- - The MCP server serves 62 tools, 3 prompts, and 1 listable resource over stdio. `COAIAJS_FEATURES` (`MINIMAL`/`STANDARD`/`OBSERVABILITY`/`FULL`) controls the tool set; default is `STANDARD`.
12
+ - The MCP server serves 67 tools, 3 prompts, and 1 listable resource over stdio. `COAIAJS_FEATURES` (`MINIMAL`/`STANDARD`/`OBSERVABILITY`/`FULL`) controls the tool set; default is `STANDARD`.
13
13
 
14
14
  ## Documentation
15
15
 
@@ -17,6 +17,7 @@ Key facts an agent usually needs first:
17
17
  - [llms-full.txt](./llms-full.txt): complete API surface — every export, every MCP tool, every CLI command, in one file
18
18
  - [CLAUDE.md](./CLAUDE.md): repository conventions for agents working *on* this codebase
19
19
  - [KINSHIP.md](./KINSHIP.md): lineage and type provenance from the four origin projects
20
+ - [docs/LINEAGE-COAIA-NARRATIVE.md](./docs/LINEAGE-COAIA-NARRATIVE.md): how corrections are carried forward from `avadisabelle/coaia-narrative` — where the last port stopped, how to find the next one, and what is deliberately not copied
20
21
 
21
22
  ## Entry points
22
23
 
@@ -30,7 +31,9 @@ Key facts an agent usually needs first:
30
31
  - `coaiajs/version`: `getPackageVersion`
31
32
  - `coaiajs/langfuse`: Langfuse v4-compatible OpenTelemetry tracing, Observations API v2, Scores API v3, prompts, datasets, comments, media, projects
32
33
  - `coaiajs/media-upload-proxy`: deployable `openaiFileIdRefs` to Langfuse media upload bridge (`coaiajs-media-proxy` binary)
33
- - `coaiajs/narrative`: `KnowledgeGraphManager`, structural tension charts, markdown export
34
+ - `coaiajs/narrative`: `KnowledgeGraphManager`, structural tension charts, markdown export, Wampum Belt sequencing, GitHub issue linkage, loss-free JSONL round-tripping
35
+ - `coaiajs/narrative/contract`: the store read contract for renderers — zero I/O, tolerant of a bad line
36
+ - `coaiajs/skill`: the packaged agent skill — render, install, and check it (`coaia skill show|install|check`)
34
37
  - `coaiajs/pde`: Prompt Decomposition Engine — sessions, STC mapping
35
38
  - `coaiajs/planning`: `parsePlan`, `planToSTC`, `syncToChart`, `syncToPlan`
36
39
  - `coaiajs/pipeline`: pipeline template engine
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "coaiajs",
3
- "version": "0.4.3",
3
+ "version": "0.5.1",
4
4
  "type": "module",
5
5
  "description": "CoAIA unified TypeScript monorepo — CLI, MCP server, and library consolidating coaia-narrative, coaia-pde, coaia-planning, and coaiapy patterns into one package.",
6
6
  "main": "./dist/src/index.js",
@@ -50,6 +50,14 @@
50
50
  "types": "./dist/src/narrative/index.d.ts",
51
51
  "import": "./dist/src/narrative/index.js"
52
52
  },
53
+ "./narrative/contract": {
54
+ "types": "./dist/src/narrative/contract.d.ts",
55
+ "import": "./dist/src/narrative/contract.js"
56
+ },
57
+ "./skill": {
58
+ "types": "./dist/src/skill.d.ts",
59
+ "import": "./dist/src/skill.js"
60
+ },
53
61
  "./pde": {
54
62
  "types": "./dist/src/pde/index.d.ts",
55
63
  "import": "./dist/src/pde/index.js"
@@ -66,6 +74,8 @@
66
74
  },
67
75
  "files": [
68
76
  "dist",
77
+ "skills",
78
+ "docs",
69
79
  "agents/custom_gpt",
70
80
  "rispecs",
71
81
  "README.md",