@dendelion/paper-camp 0.19.0 → 0.21.0

package/dist/core/roadmap.d.ts

@@ -1,10 +1,31 @@
 import { PlanEntry, ResolvedRoadmap, Roadmap, RoadmapEvent, TaskLogEntry } from '../types/index';
+/**
+ * Only `## The goal`, `## Horizon N — …`, and `## Standing concerns` headings are
+ * inspected; other prose (intro, "How this file works") is skipped.
+ */
 export declare function parseRoadmap(markdown: string): Roadmap;
+/**
+ * Removes one item's bullet (with its continuation lines and candidates), or — if
+ * `candidateName` is given — just that one candidate bullet, leaving the item in place.
+ */
 export declare function removeRoadmapItem(markdown: string, horizonTitle: string, itemName: string, candidateName?: string): string;
+/**
+ * Appends a new item bullet (`- **name** — description`) at the end of a horizon's
+ * item list, in the shape parseItems expects. No-op if the horizon doesn't exist.
+ */
 export declare function addRoadmapItem(markdown: string, horizonTitle: string, name: string, description: string): string;
 export declare function addRoadmapCandidate(markdown: string, horizonTitle: string, itemName: string, candidateName: string): string;
 export declare function linkRoadmapItem(markdown: string, horizonTitle: string, itemName: string, entityId: string): string;
+/**
+ * The subject vocabulary in order: horizon items (H1 near-term → H3 long bets), then
+ * standing concerns last. The one ordered read every subject picker/grouping should use.
+ */
 export declare function deriveSubjectVocabulary(roadmap: Roadmap): string[];
 export declare function resolveRoadmap(roadmap: Roadmap, entities: PlanEntry[], taskLog?: TaskLogEntry[], changelog?: string): ResolvedRoadmap;
+/**
+ * One chronological model over two append-only sources, keyed back to the roadmap item
+ * via its `linked` entity ids. `updated` is deliberately excluded (see IDEA-92's Timeline
+ * phase) since a last-touched timestamp can't stand in for history.
+ */
 export declare function deriveRoadmapEvents(roadmap: Roadmap, entities: PlanEntry[], taskLog: TaskLogEntry[]): RoadmapEvent[];
 //# sourceMappingURL=roadmap.d.ts.map

package/dist/core/roadmap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"roadmap.d.ts","sourceRoot":"","sources":["../../src/core/roadmap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,OAAO,EACP,YAAY,EAEZ,YAAY,EACb,MAAM,gBAAgB,CAAC;AAkDxB,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAoCtD;AA8CD,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM,CAkBR;AAKD,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,MAAM,CASR;AAID,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,MAAM,CAOR;AAID,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,MAAM,CAOR;AAKD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAKlE;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,SAAS,EAAE,EACrB,OAAO,GAAE,YAAY,EAAO,EAC5B,SAAS,SAAK,GACb,eAAe,CAsCjB;AAKD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,SAAS,EAAE,EACrB,OAAO,EAAE,YAAY,EAAE,GACtB,YAAY,EAAE,CAyChB"}
+{"version":3,"file":"roadmap.d.ts","sourceRoot":"","sources":["../../src/core/roadmap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,OAAO,EACP,YAAY,EAEZ,YAAY,EACb,MAAM,gBAAgB,CAAC;AA+CxB;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAoCtD;AAyCD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM,CAkBR;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,MAAM,CASR;AAID,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,MAAM,CAOR;AAID,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,MAAM,CAOR;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAKlE;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,SAAS,EAAE,EACrB,OAAO,GAAE,YAAY,EAAO,EAC5B,SAAS,SAAK,GACb,eAAe,CAsCjB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,SAAS,EAAE,EACrB,OAAO,EAAE,YAAY,EAAE,GACtB,YAAY,EAAE,CAyChB"}

package/dist/core/run-order.d.ts

@@ -1,3 +1,4 @@
+import { EntityKind } from '../types/index';
 import { RunOrderFileEntry } from './run-order-file';
 /** Classification input — status must be the DERIVED status (what the UI shows),
  *  not the stored frontmatter override, or merged-PR `done` entries get ordered. */
@@ -19,7 +20,7 @@ export declare function classifyRunOrderEntries(entries: {
     title: string;
     created: string;
     status?: string;
-    kind?: 'note';
+    kind?: EntityKind;
 }[], work: {
     id?: string;
     status?: string;

package/dist/core/run-order.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-order.d.ts","sourceRoot":"","sources":["../../src/core/run-order.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAI1D;oFACoF;AACpF,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,GAAG,OAAO,CAE1E;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,EACzF,IAAI,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,EACxC,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK;IAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG,SAAS,GACzE,aAAa,EAAE,CAejB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,iBAAiB,EAAE,EACzB,OAAO,EAAE,aAAa,EAAE,EACxB,KAAK,CAAC,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACpC,iBAAiB,EAAE,CA6BrB;AAED,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,CAAC,EAAE,iBAAiB,EAAE,EAAE,CAAC,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAEpF"}
+{"version":3,"file":"run-order.d.ts","sourceRoot":"","sources":["../../src/core/run-order.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAI1D;oFACoF;AACpF,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,GAAG,OAAO,CAE1E;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE;IACP,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB,EAAE,EACH,IAAI,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,EACxC,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK;IAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG,SAAS,GACzE,aAAa,EAAE,CAmBjB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,iBAAiB,EAAE,EACzB,OAAO,EAAE,aAAa,EAAE,EACxB,KAAK,CAAC,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACpC,iBAAiB,EAAE,CA6BrB;AAED,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,CAAC,EAAE,iBAAiB,EAAE,EAAE,CAAC,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAEpF"}

package/dist/core/scaffold/scaffold.d.ts

@@ -1,10 +1,9 @@
-export declare const PAPER_CAMP_VERSION = "0.1.0";
+export declare const PAPER_CAMP_VERSION: string;
 export declare class AlreadyInitializedError extends Error {
     constructor(targetDir: string);
 }
 export interface InitOptions {
     projectName: string;
-    intent?: string;
 }
 export declare function initProject(targetDir: string, options: InitOptions): Promise<void>;
 //# sourceMappingURL=scaffold.d.ts.map

package/dist/core/scaffold/scaffold.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../../src/core/scaffold/scaffold.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAE1C,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,SAAS,EAAE,MAAM;CAG9B;AAaD,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAmDxF"}
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../../src/core/scaffold/scaffold.ts"],"names":[],"mappings":"AA+BA,eAAO,MAAM,kBAAkB,QAAmB,CAAC;AAEnD,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,SAAS,EAAE,MAAM;CAG9B;AAaD,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA4CxF"}

package/dist/core/scaffold/templates.d.ts

@@ -1,3 +1,3 @@
-export declare const SKILL_MD_CONTENT = "---\nname: paper-camp\ndescription: Work inside a project that has a papercamp/ folder \u2014 its unified idea entities (each holding its plan as a section), with decisions and open questions logged as notes on the idea they bind. Use this whenever the working directory contains papercamp/ (papercamp/ideas/), and especially before starting, continuing, or completing any plan phase, drafting an idea, logging a decision, or answering \"what are we working on / what's next\".\n---\n\n# Paper Camp\n\nPaper Camp is this project's planning methodology: plans and ideas are one\nthing, a unified entity file under `papercamp/ideas/`, with decisions and\nopen questions logged as notes bound to the idea they concern. This skill\ntells you how to read that state before acting and how to keep it honest as\nyou work.\n\nIf a `papercamp` MCP server is connected in this session, prefer its tools\n(list/get plans, update phase, etc.) over raw file access \u2014\nthey enforce the same guards (id allocation, branch conflicts) that the file\ngrammar below assumes. Everything in this skill still applies conceptually;\nonly the mechanism changes.\n\n## Before doing any work\n\nRead, in this order, whatever exists:\n\n1. `papercamp/ideas/index.md` \u2014 every entity's id/title/type/status/tags, at\n   a glance. Ideas and plans are one thing: an entity is an *idea* for its\n   whole life, and its plan is a `### Phases` section inside the same file.\n2. The specific entity file at `papercamp/ideas/<ID>.md` (e.g. `IDEA-43.md`)\n   for the work you're about to do \u2014 YAML frontmatter (`id`, `title`,\n   `type`, `status`, `tags`, ...) plus prose rationale, then optionally a\n   `### Phases` list of `- [ ]`/`- [x]` checkboxes with an indented\n   description under each. Done/dropped entities live in\n   `papercamp/ideas/archive/`.\n   Its notes carry any decision or open question bound to it \u2014 settled calls\n   you shouldn't re-litigate without flagging it to the user first, and\n   unresolved questions that might block or redirect the work you're about\n   to start.\n\nSkip files that don't exist yet (a fresh project may have empty logs).\n\n## While working\n\n- Work one plan phase at a time unless told otherwise \u2014 don't cascade into\n  later phases just because they look quick.\n- If a phase's boundary or intent is unclear, ask before continuing.\n- Prose in plans and ideas is more current than your memory of past\n  conversations. If they conflict, the files win \u2014 say so and resync.\n\n## Keep the project current as you go\n\n- **Plan phases**: when you finish a phase, flip its checkbox from `- [ ]` to\n  `- [x]` in the plan's frontmatter file. Change only that line \u2014 don't touch\n  other phases or prose.\n- **Plan status**: keep the plan's `status:` frontmatter honest\n  (`planned` / `in-progress` / `review` / `done`). When every phase is\n  checked, set status to `review` \u2014 never `done`. `done` is a human-only\n  promotion after review; an agent finishing the last phase does not close\n  the plan itself.\n- **Decisions / open questions**: if you settle something ambiguous while\n  working, log it as a decision note on the idea it bounds; if you surface a\n  question you can't resolve yourself, add it as a question note on that idea\n  rather than guessing silently.\n\n## What this skill deliberately does not do\n\nIt does not maintain a separate \"current focus\" file \u2014 that's derived at\nsession start from live plan data, not hand-maintained here. It does\nnot define the file formats in full; treat the existing files under\n`papercamp/` as the grammar reference (mirror their structure exactly rather\nthan inventing a new shape).\n";
+export declare const SKILL_MD_CONTENT = "---\nname: paper-camp\ndescription: Work inside a project that has a papercamp/ folder \u2014 its unified idea entities (each holding its plan as a section), with decisions and open questions logged as notes on the idea they bind. Use this whenever the working directory contains papercamp/ (papercamp/ideas/), and especially before starting, continuing, or completing any plan phase, drafting an idea, logging a decision, or answering \"what are we working on / what's next\".\n---\n\n# Paper Camp\n\nPaper Camp is this project's planning methodology: plans and ideas are one\nthing, a unified entity file under `papercamp/ideas/`, with decisions and\nopen questions logged as notes bound to the idea they concern. This skill\ntells you how to read that state before acting and how to keep it honest as\nyou work.\n\nIf a `papercamp` MCP server is connected in this session, prefer its tools\n(list/get plans, update phase, etc.) over raw file access \u2014\nthey enforce the same guards (id allocation, branch conflicts) that the file\ngrammar below assumes. Everything in this skill still applies conceptually;\nonly the mechanism changes.\n\n## Before doing any work\n\nRead, in this order, whatever exists:\n\n1. `papercamp/ideas/` \u2014 one file per entity, named by id. Ideas and plans are\n   one thing: an entity is an *idea* for its whole life, and its plan is a\n   `### Phases` section inside the same file.\n2. The specific entity file at `papercamp/ideas/<ID>.md` (e.g. `IDEA-43.md`)\n   for the work you're about to do \u2014 YAML frontmatter (`id`, `title`,\n   `type`, `status`, `tags`, ...) plus prose rationale, then optionally a\n   `### Phases` list of `- [ ]`/`- [x]` checkboxes with an indented\n   description under each. Done/dropped entities live in\n   `papercamp/ideas/archive/`.\n   Its notes carry any decision or open question bound to it \u2014 settled calls\n   you shouldn't re-litigate without flagging it to the user first, and\n   unresolved questions that might block or redirect the work you're about\n   to start.\n\nSkip files that don't exist yet (a fresh project may have empty logs).\n\n## While working\n\n- Work one plan phase at a time unless told otherwise \u2014 don't cascade into\n  later phases just because they look quick.\n- If a phase's boundary or intent is unclear, ask before continuing.\n- Prose in plans and ideas is more current than your memory of past\n  conversations. If they conflict, the files win \u2014 say so and resync.\n\n## Keep the project current as you go\n\n- **Plan phases**: when you finish a phase, flip its checkbox from `- [ ]` to\n  `- [x]` in the plan's frontmatter file. Change only that line \u2014 don't touch\n  other phases or prose.\n- **Plan status**: keep the plan's `status:` frontmatter honest\n  (`planned` / `in-progress` / `review` / `done`). When every phase is\n  checked, set status to `review` \u2014 never `done`. `done` is a human-only\n  promotion after review; an agent finishing the last phase does not close\n  the plan itself.\n- **Decisions / open questions**: if you settle something ambiguous while\n  working, log it as a decision note on the idea it bounds; if you surface a\n  question you can't resolve yourself, add it as a question note on that idea\n  rather than guessing silently.\n\n## What this skill deliberately does not do\n\nIt does not maintain a separate \"current focus\" file \u2014 that's derived at\nsession start from live plan data, not hand-maintained here. It does\nnot define the file formats in full; treat the existing files under\n`papercamp/` as the grammar reference (mirror their structure exactly rather\nthan inventing a new shape).\n";
 export declare const CLAUDE_SETTINGS_JSON: string;
 //# sourceMappingURL=templates.d.ts.map

package/dist/core/scaffold/templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/core/scaffold/templates.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,moHAqE5B,CAAC;AAIF,eAAO,MAAM,oBAAoB,QAa5B,CAAC"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/core/scaffold/templates.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,smHAqE5B,CAAC;AAIF,eAAO,MAAM,oBAAoB,QAa5B,CAAC"}

package/dist/core/sections.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sections.d.ts","sourceRoot":"","sources":["../../src/core/sections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,UAAU,EAGV,SAAS,EACT,aAAa,EAEd,MAAM,gBAAgB,CAAC;AAGxB,QAAA,MAAM,cAAc,QAAe,CAAC;AAmHpC;;;;;4EAK4E;AAC5E,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC,EAAE,CAAC;IACnE,WAAW,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;CACzC;AAED,eAAO,MAAM,cAAc,EAAE,UAAU,CAAC,SAAS,CAIhD,CAAC;AAEF;8EAC8E;AAC9E,eAAO,MAAM,aAAa,EAAE,UAAU,CAAC,SAAS,CAI/C,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,UAAU,CAAC,QAAQ,CAI5C,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,UAAU,CAAC,QAAQ,CAIvD,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,UAAU,CAAC,UAAU,CAIhD,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,UAAU,CAAC,QAAQ,CAI/C,CAAC;AA8BF,eAAO,MAAM,cAAc,EAAE,UAAU,CAAC,aAAa,CAIpD,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"sections.d.ts","sourceRoot":"","sources":["../../src/core/sections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,UAAU,EAGV,SAAS,EACT,aAAa,EAEd,MAAM,gBAAgB,CAAC;AAGxB,QAAA,MAAM,cAAc,QAAe,CAAC;AAwJpC;;;;;4EAK4E;AAC5E,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC,EAAE,CAAC;IACnE,WAAW,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;CACzC;AAED,eAAO,MAAM,cAAc,EAAE,UAAU,CAAC,SAAS,CAIhD,CAAC;AAEF;8EAC8E;AAC9E,eAAO,MAAM,aAAa,EAAE,UAAU,CAAC,SAAS,CAI/C,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,UAAU,CAAC,QAAQ,CAI5C,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,UAAU,CAAC,QAAQ,CAIvD,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,UAAU,CAAC,UAAU,CAIhD,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,UAAU,CAAC,QAAQ,CAI/C,CAAC;AAoCF,eAAO,MAAM,cAAc,EAAE,UAAU,CAAC,aAAa,CAIpD,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/core/serialize/entity-file.d.ts

@@ -0,0 +1,79 @@
+import { LogEntry, MarginNote, PhaseItem, SuggestionEntry, ThreadMessage } from '../../types/index';
+export declare function todayDateString(): string;
+/** Every agent-authored thread message must carry `from: 'agent'` or it renders as the
+ * user's own message in the feedback chat — build them through here so it can't be forgotten. */
+export declare function agentThreadMessage(text: string, kind?: ThreadMessage['kind']): ThreadMessage;
+interface NewPlanInput {
+    title: string;
+    status: string;
+    kind?: string;
+    id?: string;
+    idea?: string;
+    agent?: string;
+    created: string;
+    updated?: string;
+    tags?: string[];
+    body?: string;
+    phases?: PhaseItem[];
+    log?: LogEntry[];
+    clarifications?: LogEntry[];
+    notes?: MarginNote[];
+}
+export declare function formatPlanEntry(input: NewPlanInput): string;
+export declare function formatPlans(entries: NewPlanInput[]): string;
+export declare function serializeFrontmatter(data: Record<string, unknown>): string;
+interface NewPlanFileInput {
+    id: string;
+    title: string;
+    kind: string;
+    status: string;
+    idea?: string;
+    agent?: string;
+    created: string;
+    updated?: string;
+    audited?: string;
+    auditedHash?: string;
+    tags?: string[];
+    body?: string;
+    phases?: PhaseItem[];
+    log?: LogEntry[];
+    clarifications?: LogEntry[];
+    notes?: MarginNote[];
+}
+export declare function formatPlanFile(input: NewPlanFileInput): string;
+interface NewEntityFileInput {
+    id: string;
+    title: string;
+    type?: string;
+    kind?: string;
+    status?: string;
+    idea?: string;
+    agent?: string;
+    created: string;
+    updated?: string;
+    audited?: string;
+    auditedHash?: string;
+    released?: string;
+    tags?: string[];
+    subject?: string;
+    order?: number;
+    issueSource?: string;
+    body?: string;
+    phases?: PhaseItem[];
+    fixes?: PhaseItem[];
+    thread?: ThreadMessage[];
+    unknownFrontmatter?: Record<string, unknown>;
+}
+export declare function formatEntityFile(input: NewEntityFileInput): string;
+interface NewIdeaFileInput {
+    id: string;
+    title: string;
+    kind?: string;
+    status?: string;
+    body?: string;
+    log?: LogEntry[];
+}
+export declare function formatIdeaFile(input: NewIdeaFileInput): string;
+export declare function removeSuggestionLine(markdown: string, target: SuggestionEntry): string;
+export {};
+//# sourceMappingURL=entity-file.d.ts.map

package/dist/core/serialize/entity-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-file.d.ts","sourceRoot":"","sources":["../../../src/core/serialize/entity-file.ts"],"names":[],"mappings":"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"}

package/dist/core/serialize/index.d.ts

@@ -1,3 +1,4 @@
+export * from './entity-file';
 export * from './serializer';
 export * from './content-hash';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/serialize/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/serialize/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/serialize/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}

package/dist/core/serialize/serializer.d.ts

@@ -1,79 +1,6 @@
-import { EntityEntry, LogEntry, MarginNote, PhaseItem, SuggestionEntry, ThreadMessage } from '../../types/index';
-export declare function todayDateString(): string;
-export declare function agentThreadMessage(text: string, kind?: ThreadMessage['kind']): ThreadMessage;
 export declare function assignPlanId(configPath: string, kind: string): Promise<string | undefined>;
-interface NewPlanInput {
-    title: string;
-    status: string;
-    kind?: string;
-    id?: string;
-    idea?: string;
-    agent?: string;
-    created: string;
-    updated?: string;
-    tags?: string[];
-    body?: string;
-    phases?: PhaseItem[];
-    log?: LogEntry[];
-    clarifications?: LogEntry[];
-    notes?: MarginNote[];
-}
-export declare function formatPlanEntry(input: NewPlanInput): string;
-export declare function formatPlans(entries: NewPlanInput[]): string;
-export declare function serializeFrontmatter(data: Record<string, unknown>): string;
-interface NewPlanFileInput {
-    id: string;
-    title: string;
-    kind: string;
-    status: string;
-    idea?: string;
-    agent?: string;
-    created: string;
-    updated?: string;
-    audited?: string;
-    auditedHash?: string;
-    tags?: string[];
-    body?: string;
-    phases?: PhaseItem[];
-    log?: LogEntry[];
-    clarifications?: LogEntry[];
-    notes?: MarginNote[];
-}
-export declare function formatPlanFile(input: NewPlanFileInput): string;
-interface NewEntityFileInput {
-    id: string;
-    title: string;
-    type?: string;
-    kind?: string;
-    status?: string;
-    agent?: string;
-    created: string;
-    updated?: string;
-    audited?: string;
-    auditedHash?: string;
-    released?: string;
-    tags?: string[];
-    subject?: string;
-    order?: number;
-    body?: string;
-    phases?: PhaseItem[];
-    fixes?: PhaseItem[];
-    thread?: ThreadMessage[];
-}
-export declare function formatEntityFile(input: NewEntityFileInput): string;
 export declare function assignEntityId(configPath: string): Promise<string | undefined>;
+export declare function assignTicketId(configPath: string): Promise<string | undefined>;
 export declare function ensureSubject(configPath: string, subject: string): Promise<void>;
-interface NewIdeaFileInput {
-    id: string;
-    title: string;
-    kind?: string;
-    status?: string;
-    body?: string;
-    log?: LogEntry[];
-}
-export declare function formatIdeaFile(input: NewIdeaFileInput): string;
 export declare function archiveEntityFile(root: string, entityId: string): Promise<boolean>;
-export declare function removeSuggestionLine(markdown: string, target: SuggestionEntry): string;
-export declare function formatEntitiesIndex(entities: EntityEntry[]): string;
-export {};
 //# sourceMappingURL=serializer.d.ts.map

package/dist/core/serialize/serializer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serializer.d.ts","sourceRoot":"","sources":["../../../src/core/serialize/serializer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"serializer.d.ts","sourceRoot":"","sources":["../../../src/core/serialize/serializer.ts"],"names":[],"mappings":"AAiCA,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAuBhG;AAED,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAEpF;AAED,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAEpF;AAID,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAetF;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAexF"}

package/dist/core/stats.d.ts

@@ -4,6 +4,8 @@ export declare function countThreadNotes(entities: EntityEntry[]): {
     openQuestions: number;
     decisions: number;
 };
+/** ISO 8601 week, via the standard "shift to the week's Thursday" algorithm — ties
+ * activity to a calendar week regardless of which day it started on. */
 export declare function isoWeekKey(dateStr: string): string;
 export declare function tasksPerWeek(entries: TaskLogEntry[]): TasksPerWeek[];
 export declare function usagePerWeek(entries: TaskLogEntry[]): UsagePerWeek[];

package/dist/core/stats.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/core/stats.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,YAAY,EAEZ,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,YAAY,EAEZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACb,MAAM,gBAAgB,CAAC;AAoExB,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,WAAW,EAAE,GACtB,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAOvC;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG;IACzD,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB,CAUA;AAKD,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOlD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CASpE;AAqBD,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAoBpE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,GAAG,IAAI,CAa5E;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,YAAY,GAAG,IAAI,CAa3E;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,SAAI,GAAG,QAAQ,EAAE,CAsBjF;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAyB7E"}
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/core/stats.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,YAAY,EAEZ,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,YAAY,EAEZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACb,MAAM,gBAAgB,CAAC;AAoExB,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,WAAW,EAAE,GACtB,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAOvC;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG;IACzD,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB,CAUA;AAED;wEACwE;AACxE,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOlD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CASpE;AAqBD,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAoBpE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,GAAG,IAAI,CAa5E;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,YAAY,GAAG,IAAI,CAa3E;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,SAAI,GAAG,QAAQ,EAAE,CAsBjF;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAyB7E"}

package/dist/core/status/status.d.ts

@@ -1,13 +1,34 @@
-import { EntityStatus, PhaseItem, PrInfo } from '../../types/index';
+import { EntityKind, EntityStatus, PhaseItem, PlanStatus, PrInfo } from '../../types/index';
 export interface StatusDerivationInput {
-    kind?: 'note';
+    kind?: EntityKind;
     status?: EntityStatus;
     phases: PhaseItem[];
     fixes?: PhaseItem[];
-}
-export interface ArchivabilityInput extends StatusDerivationInput {
     archived?: boolean;
 }
+export type ArchivabilityInput = StatusDerivationInput;
+/**
+ * The fix/reopen boundary predicate (IDEA-187): a done/archived entity's file is
+ * read-only, so new work spawns a linked fix entity instead. Reads the stored status,
+ * not the derived one — a merged-but-not-yet-archived idea counts once `status: done`
+ * is actually stamped (readEntities sets `archived` from the file's directory).
+ */
+export declare function isClosedEntity(entity: {
+    status?: EntityStatus;
+    archived?: boolean;
+}): boolean;
 export declare function deriveStatus(entity: StatusDerivationInput, pr: PrInfo | undefined, prLookupResolved: boolean, hasMainActivity?: boolean): EntityStatus | undefined;
+/**
+ * Mirrors deriveStatus's guards up to its `!prLookupResolved` branch: true exactly when
+ * GitHub was unreachable and nothing derivable (archived/dropped/a resolved PR) overrode
+ * the guess.
+ */
+export declare function isStatusFallback(entity: StatusDerivationInput, pr: PrInfo | undefined, prLookupResolved: boolean): boolean;
 export declare function isArchivable(entity: ArchivabilityInput, pr: PrInfo | undefined): boolean;
+/**
+ * A board's status rolls up from its tickets' derived statuses, the way a plan's rolls
+ * up from its phases, capped at `review` since closing an entity is always a human
+ * promotion (IDEA-187), never automatic.
+ */
+export declare function deriveBoardStatus(ticketStatuses: EntityStatus[]): PlanStatus;
 //# sourceMappingURL=status.d.ts.map

package/dist/core/status/status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/core/status/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEzE,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,kBAAmB,SAAQ,qBAAqB;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAUD,wBAAgB,YAAY,CAC1B,MAAM,EAAE,qBAAqB,EAC7B,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,gBAAgB,EAAE,OAAO,EACzB,eAAe,UAAQ,GACtB,YAAY,GAAG,SAAS,CAoB1B;AAID,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAIxF"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/core/status/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEjG,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,kBAAkB,GAAG,qBAAqB,CAAC;AAEvD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE;IAAE,MAAM,CAAC,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAE7F;AAUD,wBAAgB,YAAY,CAC1B,MAAM,EAAE,qBAAqB,EAC7B,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,gBAAgB,EAAE,OAAO,EACzB,eAAe,UAAQ,GACtB,YAAY,GAAG,SAAS,CAsB1B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,qBAAqB,EAC7B,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,gBAAgB,EAAE,OAAO,GACxB,OAAO,CAMT;AAID,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAIxF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,YAAY,EAAE,GAAG,UAAU,CAK5E"}

package/dist/types/index.d.ts

@@ -1,3 +1,4 @@
+export declare const PAIRING_TOKEN_HEADER: "x-pairing-token";
 export type PlanStatus = 'idea' | 'planned' | 'in-progress' | 'review' | 'done' | 'dropped';
 export declare const PLAN_STATUSES: PlanStatus[];
 export interface LogEntry {
@@ -20,7 +21,7 @@ export interface PhaseItem {
     done: boolean;
     text: string;
     description?: string;
-    source?: 'review' | 'manual';
+    source?: 'review' | 'manual' | 'issue';
     run?: PhaseRun;
 }
 export type PhaseMilestone = 'implement' | 'verify' | 'checkbox';
@@ -114,6 +115,9 @@ export interface PrReviewFinding {
     body: string;
 }
 export type PrReviewVerdict = 'approve' | 'comment' | 'request-changes';
+/** Parsed from the JSON object a pr-review agent's prompt requires as its final
+ * line (see buildPrReviewPrompt). `findings` become per-line PR review comments;
+ * the other fields are rendered per destination. */
 export interface PrReviewResult {
     verdict: PrReviewVerdict;
     assessment: string;
@@ -132,6 +136,9 @@ export interface FeedbackEdit {
     /** The complete replacement body, when the message corrects body prose. */
     body?: string;
 }
+/** Parsed from the JSON object a feedback-reply agent's prompt requires as its
+ * final line. The chat never creates ideas — a request is either a reply or an
+ * edit on the current plan. */
 export interface FeedbackReplyResult {
     reply: string;
     edit?: FeedbackEdit;
@@ -170,6 +177,9 @@ export interface PlanEntry {
     title: string;
     status: PlanStatus;
     kind?: PlanKind;
+    /** 'fix'/'board'/'ticket' mark a structural role beyond a plain plan-bearing idea —
+     * undefined for an ordinary one. Distinct from `kind`, which carries the commit type. */
+    entityKind?: EntityKind;
     id?: string;
     idea?: string;
     agent?: AgentId;
@@ -184,6 +194,8 @@ export interface PlanEntry {
     subject?: string;
     /** Absent means unordered — sorts after all ordered entries, by created date. */
     order?: number;
+    /** See EntityEntry.issueSource. */
+    issueSource?: string;
     body: string;
     phases: PhaseItem[];
     /** Post-build findings, same checkbox grammar as `phases` — see EntityEntry.fixes. */
@@ -199,6 +211,9 @@ export interface PlanEntry {
     /** Set by readEntities from which dir the file came from — see EntityEntry.archived. */
     archived?: boolean;
     pr?: PrInfo;
+    /** True when `status` is a guessed fallback because GitHub's PR state
+     * couldn't be resolved — see isStatusFallback. */
+    statusFallback?: boolean;
 }
 export interface ArchivableIdea {
     id: string;
@@ -307,15 +322,21 @@ export interface IdeaEntry {
 export type EntityType = PlanKind;
 /** Plan lifecycle plus the note-only `open`. Notes use open → done/dropped; everything else uses the PlanStatus track. */
 export type EntityStatus = PlanStatus | 'open';
+/** "note" never grows phases; "fix" is a follow-up entity linked to a done/archived
+ * parent via `idea` — see entityFrontmatterSchema. "board" carries no phases, decomposing
+ * into "ticket" children instead (IDEA-201) — a ticket is a full entity with its own
+ * `TICKET-N` id, linked back to its board via `idea`. Omitted for a normal idea. */
+export type EntityKind = 'note' | 'fix' | 'board' | 'ticket';
 export interface EntityEntry {
     id: string;
     title: string;
     /** Absent until the entity is classified (usually when its plan is drafted). */
     type?: EntityType;
-    /** "note" marks an entity that never grows phases. */
-    kind?: 'note';
+    kind?: EntityKind;
     /** Stored override, not the source of truth — see entityFrontmatterSchema. */
     status?: EntityStatus;
+    /** IDEA-N backlink to the parent this fix addresses; required when kind: fix. */
+    idea?: string;
     agent?: AgentId;
     created: string;
     updated?: string;
@@ -326,8 +347,15 @@ export interface EntityEntry {
     tags: string[];
     /** Absent renders as the virtual "No subject" group. */
     subject?: string;
-    /** Absent means unordered — sorts after all ordered entries, by created date. */
+    /** Absent means unordered — sorts after all ordered entries, by created date. Overlaid
+     * with the run-order rank by readEntities — see `storedOrder` for the frontmatter value. */
     order?: number;
+    /** The frontmatter `order` as read from disk, before readEntities overlays the run-order
+     * rank onto `order` — what a write path should persist back. See entityFileInput. */
+    storedOrder?: number;
+    /** The Issue.id this entity was spawned to promote, if any — how a promoted
+     * issue is re-matched to its target on every read. */
+    issueSource?: string;
     body: string;
     phases: PhaseItem[];
     /** Post-build findings, same checkbox grammar as `phases` — appended below Phases
@@ -338,6 +366,9 @@ export interface EntityEntry {
     thread?: ThreadMessage[];
     /** Set by readEntities from which of the two scanned dirs the file came from, not the frontmatter. */
     archived?: boolean;
+    /** Frontmatter keys this paper-camp doesn't recognise, carried through verbatim so a
+     * write never drops a field a newer version wrote — see entityFrontmatterKnownKeys. */
+    unknownFrontmatter?: Record<string, unknown>;
 }
 export interface SuggestionEntry {
     date: string;
@@ -505,12 +536,16 @@ export interface CiReleaseState {
     releasedVersion: string | null;
 }
 export interface PaperCampConfig {
-    version: string;
+    /** Corpus format version (see CORPUS_FORMAT_VERSION) — the shape this file and the
+     * entity frontmatter it sits alongside conform to, not the npm package version. */
+    version: number;
     projectName: string;
     initializedAt: string;
-    /** The unified-entity `idea` counter; the per-kind plan counters are legacy, present only in pre-migration configs. */
+    /** The unified-entity `idea` counter, plus the `ticket` counter (IDEA-201); the
+     * per-kind plan counters are legacy, present only in pre-migration configs. */
     nextId?: Partial<Record<PlanKind, number>> & {
         idea?: number;
+        ticket?: number;
     };
     port?: number;
     defaultAgents?: DefaultAgentsMap;
@@ -556,6 +591,11 @@ export interface LoginRelayState {
     error?: string;
 }
 export type ServiceId = 'git' | 'gh' | `agent:${AgentId}`;
+/** The two plugin extension points (IDEA-193): 'external' reaches another system on
+ * the user's behalf (GitHub today) with a remote-account credential; 'local' is a
+ * tool the runtime drives on the machine (git, an agent CLI) with its own local
+ * session, never a remote identity. */
+export type PluginKind = 'external' | 'local';
 /** What a Connections row offers once its service isn't `ok` — copy a command, follow a link, or read plain instructions. */
 export type ConnectAction = 
 /** `runnable` marks a command with no placeholders and no interactive prompts — safe for the server to execute directly instead of just displaying it. */
@@ -573,6 +613,7 @@ export type ConnectAction =
 };
 export interface ConnectionResult {
     id: ServiceId;
+    kind: PluginKind;
     label: string;
     unlocks: string;
     status: CapabilityStatus;
@@ -663,7 +704,7 @@ export type GitSyncResult = {
     ok: true;
 } | GitSyncFailure;
 export type AgentTaskStatus = 'starting' | 'running' | 'stopping' | 'done' | 'error' | 'superseded';
-export type TaskKind = 'phase' | 'audit' | 'batch-reconcile' | 'batch-draft' | 'run-all' | 'draft' | 'extend' | 'suggest' | 'commit-suggest' | 'overlap-check' | 'prioritise' | 'sync' | 'reconcile' | 'fix-review' | 'resolve-conflict' | 'feedback' | 'pr-review';
+export type TaskKind = 'phase' | 'audit' | 'batch-reconcile' | 'batch-draft' | 'run-all' | 'draft' | 'extend' | 'suggest' | 'commit-suggest' | 'overlap-check' | 'prioritise' | 'sync' | 'reconcile' | 'fix-review' | 'resolve-conflict' | 'feedback' | 'pr-review' | 'issue-fix';
 export interface TaskLogEntry {
     id: string;
     taskKind: TaskKind;
@@ -677,6 +718,9 @@ export interface TaskLogEntry {
     usage?: RunUsage;
     phaseRuns?: PhaseRunRecord[];
     rateLimit?: RateLimitSnapshot;
+    /** issue-fix only: the Issue.id (IDEA-192) this run was launched to fix, so a
+     * repeat failure's thread can be reconstructed by matching entries to the issue. */
+    issueId?: string;
 }
 export interface RunUsage {
     durationMs: number;
@@ -747,6 +791,7 @@ export interface AgentTaskState {
     prReviewUrl?: string;
     errorKind?: 'auth' | 'question';
     rateLimit?: RateLimitSnapshot;
+    issueId?: string;
 }
 export interface OverlapVerdict {
     verdict: 'existing' | 'extend' | 'new';
@@ -756,7 +801,9 @@ export interface OverlapVerdict {
 /** `why` carries one line per entry in `order`, same index — the reason for that id's placement. */
 export interface PrioritiseVerdict {
     order: string[];
-    why: string;
+    /** One reason per `order` entry, same index. May be short if the agent
+     * under-supplied after a retry — callers fall back per missing index. */
+    why: string[];
 }
 export interface ReconcileQueueItem {
     planId: string;
@@ -766,4 +813,35 @@ export interface ReconcileQueueItem {
         phases: PhaseItem[];
     };
 }
+/** The four failures IDEA-192 collects into one place: a failed agent run, a red
+ * project check, a PR review that requested changes, and a git rebase/sync failure. */
+export type IssueSourceKind = 'agent-run' | 'check' | 'pr-review' | 'sync';
+/** Derived from the world on every read, never a mark-read button — 'open' while a
+ * collector still finds the failure, 'closed' once it doesn't or the promoted fix
+ * that carries it ships. */
+export type IssueStatus = 'open' | 'closed';
+/** One collected failure (IDEA-192), read as a short thread. `id` is derived from
+ * `sourceKind` + `sourceKey`, so a repeat failure of the same thing resolves to the
+ * same issue and continues its thread instead of raising a duplicate. */
+export interface Issue {
+    id: string;
+    sourceKind: IssueSourceKind;
+    /** Stable within `sourceKind` — a task's `planId`, a check's `name`, a PR's
+     * `number` + `headSha`, or a sync failure's branch + target ref. */
+    sourceKey: string;
+    entityId?: string;
+    entityTitle?: string;
+    title: string;
+    reason: string;
+    /** Last output lines, when the source captured any (a check's command output, a
+     * sync failure's conflicted files). */
+    output?: string;
+    /** Absent when the source carries no timestamp of its own (a live PR review decision). */
+    occurredAt?: string;
+    thread: ThreadMessage[];
+    status: IssueStatus;
+    /** Set once promoted — the id of whatever now carries the work. A promoted
+     * issue closes when that entity's status reaches 'done'. */
+    promotedFixId?: string;
+}
 //# sourceMappingURL=index.d.ts.map