@principal-ai/subsystems-core 0.50.0 → 0.51.1

package/README.md

@@ -6,7 +6,7 @@ Subsystem model types/schema and agent-session tooling for Principal AI.
 
 | Import | Use |
 |---|---|
-| `@principal-ai/subsystems-core` | Browser-safe subsystem model types + `isSubsystemModelDocument` |
+| `@principal-ai/subsystems-core` | Browser-safe subsystem model/topic types, reference links + `isSubsystemModelDocument` |
 | `@principal-ai/subsystems-core/node` | OpenCode store, agent-session list/fetch/normalize, topic store, fixtures |
 | `@principal-ai/subsystems-core/pipeline` | Bun-safe session normalize/accumulate (no `better-sqlite3`) |
 
@@ -14,6 +14,35 @@ Subsystem model types/schema and agent-session tooling for Principal AI.
 
 Portable document schema: `schemas/subsystem-model.schema.json`
 
+## Topic references
+
+`DraftTopic.references` attaches local topics and C4 sketches by ID:
+
+```ts
+import {
+  formatTopicReferenceLink,
+  parseTopicReferenceLink,
+  type TopicReference,
+} from '@principal-ai/subsystems-core';
+
+const reference: TopicReference = { kind: 'c4-sketch', sketchId: 'c4s-123-abc' };
+formatTopicReferenceLink(reference); // principal://c4-sketch/c4s-123-abc
+parseTopicReferenceLink('principal://topic/topic-123-abc');
+// { kind: 'topic', topicId: 'topic-123-abc' }
+```
+
+Create/update accepts `references`; updates replace the whole array (`[]` clears
+it). Existing topics may omit the field. References are directional and local-only.
+Targets stay separate artifacts; deleting a target leaves a missing reference,
+not a cascading deletion. Existing `subsystemModels` associations are unchanged.
+
+Markdown links such as `[Architecture](principal://c4-sketch/c4s-123-abc)` and
+`[Related](principal://topic/topic-123-abc)` use the same target shapes but are
+independent of attachments. Helpers only format/parse hrefs; hosts must allow the
+`principal` protocol in Markdown sanitizers and handle resolution, navigation,
+target validation, deduplication, and self-reference rejection. Sketch references
+do not turn authored hypotheses into evidence.
+
 ## Installation
 
 ```bash

package/dist/index.d.ts

@@ -11,6 +11,8 @@
  *   import { ... } from '@principal-ai/subsystems-core/pipeline'
  */
 export * from './types';
+export type { DraftTopic, TopicAsset, TopicCreator, TopicSubsystemModelRef, TopicReference, } from './storage/topic-types';
+export { formatTopicReferenceLink, parseTopicReferenceLink } from './storage/topic-reference-links';
 export { validateSubsystemModelCrossField } from './validation';
 export type { SubsystemValidationProblem } from './validation';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,SAAS,CAAC;AAKxB,OAAO,EAAE,gCAAgC,EAAE,MAAM,cAAc,CAAC;AAChE,YAAY,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,SAAS,CAAC;AAExB,YAAY,EACV,UAAU,EACV,UAAU,EACV,YAAY,EACZ,sBAAsB,EACtB,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAKpG,OAAO,EAAE,gCAAgC,EAAE,MAAM,cAAc,CAAC;AAChE,YAAY,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -26,8 +26,11 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateSubsystemModelCrossField = void 0;
+exports.validateSubsystemModelCrossField = exports.parseTopicReferenceLink = exports.formatTopicReferenceLink = void 0;
 __exportStar(require("./types"), exports);
+var topic_reference_links_1 = require("./storage/topic-reference-links");
+Object.defineProperty(exports, "formatTopicReferenceLink", { enumerable: true, get: function () { return topic_reference_links_1.formatTopicReferenceLink; } });
+Object.defineProperty(exports, "parseTopicReferenceLink", { enumerable: true, get: function () { return topic_reference_links_1.parseTopicReferenceLink; } });
 // Cross-field validation (the rules the JSON Schema can't express). Structural
 // (schema) validation is enforced per surface against
 // `schemas/subsystem-model.schema.json`.

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;;;;;;;;;;;;;;;AAEH,0CAAwB;AAExB,+EAA+E;AAC/E,sDAAsD;AACtD,yCAAyC;AACzC,2CAAgE;AAAvD,8HAAA,gCAAgC,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;;;;;;;;;;;;;;;AAEH,0CAAwB;AASxB,yEAAoG;AAA3F,iIAAA,wBAAwB,OAAA;AAAE,gIAAA,uBAAuB,OAAA;AAE1D,+EAA+E;AAC/E,sDAAsD;AACtD,yCAAyC;AACzC,2CAAgE;AAAvD,8HAAA,gCAAgC,OAAA"}

package/dist/node.d.ts

@@ -9,8 +9,8 @@
 export * from './types';
 export { TopicStore, PRINCIPAL_DIR, TOPICS_DIR, LEGACY_TOPICS_BLOB, } from './storage/topicStore';
 export type { TopicIndexEntry, TopicCreate, TopicUpdate, MigrationResult, } from './storage/topicStore';
-export { publishedFromDraft } from './storage/topic-types';
-export type { DraftTopic, PublishedTopic, PublishProjection, TopicStatus, TopicAsset, TopicCreator, TopicSubsystemModelRef, } from './storage/topic-types';
+export type { DraftTopic, TopicAsset, TopicCreator, TopicSubsystemModelRef, TopicReference, } from './storage/topic-types';
+export { formatTopicReferenceLink, parseTopicReferenceLink } from './storage/topic-reference-links';
 export { OpenCodeEventStore, defaultOpenCodeDBPath } from './opencode/OpenCodeEventStore';
 export type { OpenCodeRawEvent, OpenCodeSessionEvents, OpenCodeEventRetriever, OpenCodeStoreOptions, SessionSummary, SessionListResult, } from './opencode/types';
 export { listAgentSessions, detectAgent, fetchRawEvents } from './opencode/agent-sessions';

package/dist/node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,SAAS,CAAC;AAGxB,OAAO,EACL,UAAU,EACV,aAAa,EACb,UAAU,EACV,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,eAAe,EACf,WAAW,EACX,WAAW,EACX,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,YAAY,EACV,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,UAAU,EACV,YAAY,EACZ,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAC1F,YAAY,EACV,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,EACd,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3F,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,EACvB,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,4BAA4B,EAC5B,eAAe,EACf,0BAA0B,EAC1B,gBAAgB,EAChB,mBAAmB,EACnB,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,SAAS,CAAC;AAGxB,OAAO,EACL,UAAU,EACV,aAAa,EACb,UAAU,EACV,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,eAAe,EACf,WAAW,EACX,WAAW,EACX,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,UAAU,EACV,UAAU,EACV,YAAY,EACZ,sBAAsB,EACtB,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAGpG,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAC1F,YAAY,EACV,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,EACd,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3F,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,EACvB,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,4BAA4B,EAC5B,eAAe,EACf,0BAA0B,EAC1B,gBAAgB,EAChB,mBAAmB,EACnB,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/node.js

@@ -22,7 +22,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.opencodeRowsToUniversalEvents = exports.collectRepositories = exports.accumulateEvents = exports.normalizeEventsWithAdapter = exports.normalizeEvents = exports.NodePathNormalizationAdapter = exports.buildAgentSessionFixture = exports.fetchRawEvents = exports.detectAgent = exports.listAgentSessions = exports.defaultOpenCodeDBPath = exports.OpenCodeEventStore = exports.publishedFromDraft = exports.LEGACY_TOPICS_BLOB = exports.TOPICS_DIR = exports.PRINCIPAL_DIR = exports.TopicStore = void 0;
+exports.opencodeRowsToUniversalEvents = exports.collectRepositories = exports.accumulateEvents = exports.normalizeEventsWithAdapter = exports.normalizeEvents = exports.NodePathNormalizationAdapter = exports.buildAgentSessionFixture = exports.fetchRawEvents = exports.detectAgent = exports.listAgentSessions = exports.defaultOpenCodeDBPath = exports.OpenCodeEventStore = exports.parseTopicReferenceLink = exports.formatTopicReferenceLink = exports.LEGACY_TOPICS_BLOB = exports.TOPICS_DIR = exports.PRINCIPAL_DIR = exports.TopicStore = void 0;
 __exportStar(require("./types"), exports);
 // File-per-topic store (~/.principal/topics) — node:fs only
 var topicStore_1 = require("./storage/topicStore");
@@ -30,8 +30,9 @@ Object.defineProperty(exports, "TopicStore", { enumerable: true, get: function (
 Object.defineProperty(exports, "PRINCIPAL_DIR", { enumerable: true, get: function () { return topicStore_1.PRINCIPAL_DIR; } });
 Object.defineProperty(exports, "TOPICS_DIR", { enumerable: true, get: function () { return topicStore_1.TOPICS_DIR; } });
 Object.defineProperty(exports, "LEGACY_TOPICS_BLOB", { enumerable: true, get: function () { return topicStore_1.LEGACY_TOPICS_BLOB; } });
-var topic_types_1 = require("./storage/topic-types");
-Object.defineProperty(exports, "publishedFromDraft", { enumerable: true, get: function () { return topic_types_1.publishedFromDraft; } });
+var topic_reference_links_1 = require("./storage/topic-reference-links");
+Object.defineProperty(exports, "formatTopicReferenceLink", { enumerable: true, get: function () { return topic_reference_links_1.formatTopicReferenceLink; } });
+Object.defineProperty(exports, "parseTopicReferenceLink", { enumerable: true, get: function () { return topic_reference_links_1.parseTopicReferenceLink; } });
 // OpenCode event retrieval (Node.js only - SQLite)
 var OpenCodeEventStore_1 = require("./opencode/OpenCodeEventStore");
 Object.defineProperty(exports, "OpenCodeEventStore", { enumerable: true, get: function () { return OpenCodeEventStore_1.OpenCodeEventStore; } });

package/dist/node.js.map

@@ -1 +1 @@
-{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;;;AAEH,0CAAwB;AAExB,4DAA4D;AAC5D,mDAK8B;AAJ5B,wGAAA,UAAU,OAAA;AACV,2GAAA,aAAa,OAAA;AACb,wGAAA,UAAU,OAAA;AACV,gHAAA,kBAAkB,OAAA;AAQpB,qDAA2D;AAAlD,iHAAA,kBAAkB,OAAA;AAW3B,mDAAmD;AACnD,oEAA0F;AAAjF,wHAAA,kBAAkB,OAAA;AAAE,2HAAA,qBAAqB,OAAA;AAUlD,iEAAiE;AACjE,4DAA2F;AAAlF,mHAAA,iBAAiB,OAAA;AAAE,6GAAA,WAAW,OAAA;AAAE,gHAAA,cAAc,OAAA;AAOvD,mDAAmD;AACnD,oDAAoE;AAA3D,mHAAA,wBAAwB,OAAA;AAWjC,sEAAsE;AACtE,gDAO6B;AAN3B,wHAAA,4BAA4B,OAAA;AAC5B,2GAAA,eAAe,OAAA;AACf,sHAAA,0BAA0B,OAAA;AAC1B,4GAAA,gBAAgB,OAAA;AAChB,+GAAA,mBAAmB,OAAA;AACnB,yHAAA,6BAA6B,OAAA"}
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;;;AAEH,0CAAwB;AAExB,4DAA4D;AAC5D,mDAK8B;AAJ5B,wGAAA,UAAU,OAAA;AACV,2GAAA,aAAa,OAAA;AACb,wGAAA,UAAU,OAAA;AACV,gHAAA,kBAAkB,OAAA;AAepB,yEAAoG;AAA3F,iIAAA,wBAAwB,OAAA;AAAE,gIAAA,uBAAuB,OAAA;AAE1D,mDAAmD;AACnD,oEAA0F;AAAjF,wHAAA,kBAAkB,OAAA;AAAE,2HAAA,qBAAqB,OAAA;AAUlD,iEAAiE;AACjE,4DAA2F;AAAlF,mHAAA,iBAAiB,OAAA;AAAE,6GAAA,WAAW,OAAA;AAAE,gHAAA,cAAc,OAAA;AAOvD,mDAAmD;AACnD,oDAAoE;AAA3D,mHAAA,wBAAwB,OAAA;AAWjC,sEAAsE;AACtE,gDAO6B;AAN3B,wHAAA,4BAA4B,OAAA;AAC5B,2GAAA,eAAe,OAAA;AACf,sHAAA,0BAA0B,OAAA;AAC1B,4GAAA,gBAAgB,OAAA;AAChB,+GAAA,mBAAmB,OAAA;AACnB,yHAAA,6BAA6B,OAAA"}

package/dist/storage/topic-reference-links.d.ts

@@ -0,0 +1,10 @@
+import type { TopicReference } from './topic-types';
+/** Format a Markdown-safe href. Does not attach or resolve the target. */
+export declare function formatTopicReferenceLink(reference: TopicReference): string;
+/**
+ * Parse a local topic/sketch href without I/O. Unknown kinds, malformed escapes,
+ * extra path segments, queries, and fragments return null. Target existence and
+ * navigation belong to the host. Parsing never creates an attachment.
+ */
+export declare function parseTopicReferenceLink(href: string): TopicReference | null;
+//# sourceMappingURL=topic-reference-links.d.ts.map

package/dist/storage/topic-reference-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topic-reference-links.d.ts","sourceRoot":"","sources":["../../src/storage/topic-reference-links.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAQpD,0EAA0E;AAC1E,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,cAAc,GAAG,MAAM,CAQ1E;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAa3E"}

package/dist/storage/topic-reference-links.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseTopicReferenceLink = exports.formatTopicReferenceLink = void 0;
+// IDs are opaque single path segments, not paths. Decode exactly once and
+// reject traversal, separators, whitespace, and control characters.
+function isReferenceId(id) {
+    return id.length > 0 && id !== '.' && id !== '..' && !/[/\\\s\u0000-\u001f\u007f]/.test(id);
+}
+/** Format a Markdown-safe href. Does not attach or resolve the target. */
+function formatTopicReferenceLink(reference) {
+    const id = reference.kind === 'topic' ? reference.topicId : reference.sketchId;
+    if (!isReferenceId(id))
+        throw new Error('Invalid topic reference id');
+    const encoded = encodeURIComponent(id).replace(/[!'()*]/g, (character) => `%${character.charCodeAt(0).toString(16).toUpperCase()}`);
+    return `principal://${reference.kind}/${encoded}`;
+}
+exports.formatTopicReferenceLink = formatTopicReferenceLink;
+/**
+ * Parse a local topic/sketch href without I/O. Unknown kinds, malformed escapes,
+ * extra path segments, queries, and fragments return null. Target existence and
+ * navigation belong to the host. Parsing never creates an attachment.
+ */
+function parseTopicReferenceLink(href) {
+    const match = /^principal:\/\/(topic|c4-sketch)\/([^/?#]+)$/.exec(href);
+    if (!match)
+        return null;
+    let id;
+    try {
+        id = decodeURIComponent(match[2]);
+    }
+    catch {
+        return null;
+    }
+    if (!isReferenceId(id))
+        return null;
+    return match[1] === 'topic'
+        ? { kind: 'topic', topicId: id }
+        : { kind: 'c4-sketch', sketchId: id };
+}
+exports.parseTopicReferenceLink = parseTopicReferenceLink;
+//# sourceMappingURL=topic-reference-links.js.map

package/dist/storage/topic-reference-links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topic-reference-links.js","sourceRoot":"","sources":["../../src/storage/topic-reference-links.ts"],"names":[],"mappings":";;;AAEA,0EAA0E;AAC1E,oEAAoE;AACpE,SAAS,aAAa,CAAC,EAAU;IAC/B,OAAO,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,4BAA4B,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC9F,CAAC;AAED,0EAA0E;AAC1E,SAAgB,wBAAwB,CAAC,SAAyB;IAChE,MAAM,EAAE,GAAG,SAAS,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC;IAC/E,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IACtE,MAAM,OAAO,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAC,OAAO,CAC5C,UAAU,EACV,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CACxE,CAAC;IACF,OAAO,eAAe,SAAS,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC;AACpD,CAAC;AARD,4DAQC;AAED;;;;GAIG;AACH,SAAgB,uBAAuB,CAAC,IAAY;IAClD,MAAM,KAAK,GAAG,8CAA8C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxE,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,IAAI,EAAU,CAAC;IACf,IAAI;QACF,EAAE,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;KACnC;IAAC,MAAM;QACN,OAAO,IAAI,CAAC;KACb;IACD,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO;QACzB,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE;QAChC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;AAC1C,CAAC;AAbD,0DAaC"}

package/dist/storage/topic-types.d.ts

@@ -3,75 +3,24 @@
  * agrees on. Browser-safe (no `node:*`); the file-per-topic store that reads and
  * writes these lives in `./node` (see `topicStore.ts`).
  *
- * A **topic** is a locally authored subject brief that may be published. Two
- * distinct named shapes, split by id-namespace / ownership, with an explicit
- * translation between them — NOT one shared shape. Their `id` fields live in
- * different namespaces (local vs server), so passing one where the other is
- * expected corrupts topic identity.
+ * A **topic** is a locally authored subject brief. {@link DraftTopic} is the
+ * shape desktop persists to `~/.principal/topics/<id>.json` and edits.
  *
- * - {@link DraftTopic}     — locally-authored, what desktop persists + edits.
- * - {@link PublishedTopic} — server-authoritative, what the server returns and
- *                            mobile reads.
- * - {@link publishedFromDraft} — the Draft -> Published projection (one-way;
- *                            there is no reverse hydration).
- *
- * All timestamps are ISO 8601 strings because this contract crosses the
- * desktop/web boundary.
- */
-/**
- * Status of a topic — a small structured axis plus optional human nuance.
- *
- * `state` is the machine-meaningful signal (drives badge color, sorting, and
- * filtering). `label` is free-form text shown in place of the default per-state
- * label. `waitingOn` describes an external blocker and is meaningful when
- * `state` is `waiting`.
- *
- * The structured shape is deliberate: it lets automations check and resolve a
- * blocker without parsing prose — e.g. flip `waiting` -> `paused` once `until`
- * passes, or once a referenced PR merges.
+ * All timestamps are ISO 8601 strings.
  */
-export interface TopicStatus {
-    /**
-     * Structured lifecycle axis, ordered by a feature's "aliveness" from nascent
-     * to retired. Readers treat an absent OR unrecognized `state` as
-     * `new-thought`, so legacy topics and renamed values need no migration.
-     */
-    state: 'new-thought' | 'working' | 'paused' | 'waiting' | 'done-for-now' | 'deprecated' | 'abandoned';
-    /** Free-form text shown in place of the default label for the state. */
-    label?: string;
-    /** External blocker description. Meaningful when `state` is `waiting`. */
-    waitingOn?: {
-        /** Human description of the blocker, e.g. "design sign-off". */
-        note?: string;
-        /** ISO 8601 — when the hold is expected to lift. */
-        until?: string;
-        /** Structured pointer to the thing being waited on, for automations. */
-        ref?: {
-            kind: 'url' | 'pr' | 'issue' | 'topic';
-            /** The address/id of the referenced thing. */
-            value: string;
-            /** Optional human label for display. */
-            title?: string;
-        };
-    };
-}
 /**
  * An image attached to a topic — primarily a screenshot dragged into the
  * description. Bytes live on the topic (referenced from the description via an
  * `asset://<id>` markdown link), not inlined into the description string. A
  * render-time resolver swaps `asset://<id>` for `url` (preferred) or a data-URL
- * built from `data`, keeping a local (data-only) and a published (url-bearing)
- * topic interchangeable on read.
- *
- * Local-only on a {@link DraftTopic}: assets are uploaded/resolved at publish
- * time, so a {@link PublishedTopic} carries the resolved `url`, not raw `data`.
+ * built from `data`.
  */
 export interface TopicAsset {
     /** Content hash — free dedup and the stable `asset://` target. */
     id: string;
     /** MIME type, e.g. "image/png". */
     mime: string;
-    /** Base64-encoded bytes. Present locally and on publish. */
+    /** Base64-encoded bytes. */
     data?: string;
     /** Resolvable URL, when the bytes have been offloaded (e.g. to S3). */
     url?: string;
@@ -86,7 +35,7 @@ export interface TopicAsset {
 /**
  * GitHub identity of a topic's creator. Populated when a signed-in user
  * authors a topic; left undefined for local-only topics created before
- * sign-in. The server requires this on publish.
+ * sign-in.
  */
 export interface TopicCreator {
     githubId: number;
@@ -97,8 +46,8 @@ export interface TopicCreator {
  * specific runtime trails (flows) within that model.
  *
  * The link lives on the **topic** side, in the local store id namespace, and
- * never on the model: a subsystem-model document is a portable, host-free
- * artifact (shared/published) that must not embed local topic or store ids.
+ * never on the model: a subsystem-model document is a portable artifact that
+ * must not embed local topic or store ids.
  */
 export interface TopicSubsystemModelRef {
     /** Store-assigned model id, e.g. "sg-1781...". */
@@ -106,18 +55,25 @@ export interface TopicSubsystemModelRef {
     /** Specific runtime trails (flows) within the model, if narrower than the whole. */
     trailIds?: string[];
 }
+/**
+ * A directional, local-only reference owned by a topic. Targets remain separate
+ * artifacts; their contents and titles are resolved by the host, not copied here.
+ * Referencing a C4 sketch does not make its authored hypothesis evidence.
+ */
+export type TopicReference = {
+    kind: 'c4-sketch';
+    sketchId: string;
+} | {
+    kind: 'topic';
+    topicId: string;
+};
 /**
  * Locally-authored topic — the shape desktop persists to
  * `~/.principal/topics/<id>.json` and edits.
  *
- * Local id namespace. `description` / `createdBy` are optional (a Draft may be
- * authored before sign-in). Carries local-only {@link TopicAsset}s
- * (`asset://<id>` screenshots, raw `data`). Has NO `visibility` — that's a
- * published concept.
- *
- * A Draft keeps existing after publish (it can be in a "published state"); its
- * link to the server identity lives in the desktop's `topics-sync.json`
- * sidecar, not in this shape.
+ * `description` / `createdBy` are optional (a Draft may be authored before
+ * sign-in). Carries local-only {@link TopicAsset}s (`asset://<id>` screenshots,
+ * raw `data`).
  */
 export interface DraftTopic {
     /** Unique identifier in the LOCAL id namespace. */
@@ -131,7 +87,7 @@ export interface DraftTopic {
      * `pkg:github/owner/repo`). The topic's own source of truth for "which repos"
      * — portable and machine-independent, matching `WorkspaceMembership.repositoryId`.
      * Machine-local clone paths stay a workspace-membership concern and never
-     * appear here, so this round-trips across machines on publish/fetch.
+     * appear here, so this round-trips across machines.
      */
     repos?: string[];
     /** ISO 8601. */
@@ -140,74 +96,18 @@ export interface DraftTopic {
     updatedAt: string;
     /** Creator identity; undefined for topics authored before sign-in. */
     createdBy?: TopicCreator;
-    /** Optional workflow status. Absent reads as `new-thought`. */
-    status?: TopicStatus;
     /** Local image attachments, referenced from the description via `asset://<id>`. */
     assets?: TopicAsset[];
     /**
-     * Subsystem models this topic concerns, as local store ids. Local-only: not
-     * carried on publish, since the referenced models are a local artifact.
+     * Subsystem models this topic concerns, as local store ids. Local-only, since
+     * the referenced models are a local artifact.
      */
     subsystemModels?: TopicSubsystemModelRef[];
-}
-/**
- * Server-authoritative topic — the shape the server returns and mobile reads.
- *
- * Remote id namespace. `description` / `createdBy` are required (publish is the
- * validation gate). Carries `visibility`; assets have been resolved to `url`s.
- *
- * CAVEAT: "Published" means "has a server identity", NOT "public" — a
- * PublishedTopic can be `visibility: 'private'`.
- */
-export interface PublishedTopic {
-    /** Unique identifier in the REMOTE (server) id namespace. */
-    id: string;
-    /** Display title. */
-    title: string;
-    /** Markdown body — required on the server. */
-    description: string;
     /**
-     * Repositories this topic is about, as PURL strings (e.g.
-     * `pkg:github/owner/repo`). Travels with the topic across the wire so a
-     * received shared topic carries its repos; preserved on publish/fetch.
+     * Attached topics and C4 sketches. Whole-array replacement on update; `[]`
+     * clears attachments. Independent of links in `description`: neither edits
+     * the other. Hosts validate target existence and reject self-references.
      */
-    repos?: string[];
-    /** ISO 8601. */
-    createdAt: string;
-    /** ISO 8601. */
-    updatedAt: string;
-    /** Creator identity — required on the server. */
-    createdBy: TopicCreator;
-    /** Optional workflow status, travels with the topic when published. */
-    status?: TopicStatus;
-    /** Server visibility. "private" is still a PublishedTopic. */
-    visibility: 'private' | 'public';
-}
-/**
- * Inputs the {@link DraftTopic} cannot supply on its own — the namespace
- * crossing and the fields publish must enforce. The caller resolves these
- * before projecting:
- * - `createdBy`: required on the server; supplied here if the draft lacks it.
- * - `visibility`: a published concept the draft never carries.
- */
-export interface PublishProjection {
-    createdBy: TopicCreator;
-    visibility: 'private' | 'public';
+    references?: TopicReference[];
 }
-/**
- * Project a {@link DraftTopic} into a {@link PublishedTopic} — the one-way
- * Draft -> Published translation. It does NOT perform any I/O (no id minting,
- * no asset upload, no network): the caller resolves the namespace-crossing and
- * required fields into {@link PublishProjection} first (uploading assets,
- * choosing visibility), and this enforces the shape.
- *
- * One-way by design: there is no reverse `PublishedTopic -> DraftTopic`
- * hydration. A published topic's edits write through to the server; the local
- * Draft is reconciled from the server's response field-by-field, never by
- * rebuilding a Draft from a Published shape.
- *
- * Throws if `description` is empty — publish is also the validation gate, and
- * the server rejects a description-less topic.
- */
-export declare function publishedFromDraft(draft: DraftTopic, projection: PublishProjection): PublishedTopic;
 //# sourceMappingURL=topic-types.d.ts.map

package/dist/storage/topic-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"topic-types.d.ts","sourceRoot":"","sources":["../../src/storage/topic-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"topic-types.d.ts","sourceRoot":"","sources":["../../src/storage/topic-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACtD;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,mFAAmF;IACnF,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IACtB;;;OAGG;IACH,eAAe,CAAC,EAAE,sBAAsB,EAAE,CAAC;IAC3C;;;;OAIG;IACH,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;CAC/B"}

package/dist/storage/topic-types.js

@@ -4,54 +4,10 @@
  * agrees on. Browser-safe (no `node:*`); the file-per-topic store that reads and
  * writes these lives in `./node` (see `topicStore.ts`).
  *
- * A **topic** is a locally authored subject brief that may be published. Two
- * distinct named shapes, split by id-namespace / ownership, with an explicit
- * translation between them — NOT one shared shape. Their `id` fields live in
- * different namespaces (local vs server), so passing one where the other is
- * expected corrupts topic identity.
+ * A **topic** is a locally authored subject brief. {@link DraftTopic} is the
+ * shape desktop persists to `~/.principal/topics/<id>.json` and edits.
  *
- * - {@link DraftTopic}     — locally-authored, what desktop persists + edits.
- * - {@link PublishedTopic} — server-authoritative, what the server returns and
- *                            mobile reads.
- * - {@link publishedFromDraft} — the Draft -> Published projection (one-way;
- *                            there is no reverse hydration).
- *
- * All timestamps are ISO 8601 strings because this contract crosses the
- * desktop/web boundary.
+ * All timestamps are ISO 8601 strings.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.publishedFromDraft = void 0;
-/**
- * Project a {@link DraftTopic} into a {@link PublishedTopic} — the one-way
- * Draft -> Published translation. It does NOT perform any I/O (no id minting,
- * no asset upload, no network): the caller resolves the namespace-crossing and
- * required fields into {@link PublishProjection} first (uploading assets,
- * choosing visibility), and this enforces the shape.
- *
- * One-way by design: there is no reverse `PublishedTopic -> DraftTopic`
- * hydration. A published topic's edits write through to the server; the local
- * Draft is reconciled from the server's response field-by-field, never by
- * rebuilding a Draft from a Published shape.
- *
- * Throws if `description` is empty — publish is also the validation gate, and
- * the server rejects a description-less topic.
- */
-function publishedFromDraft(draft, projection) {
-    const description = (draft.description ?? '').trim();
-    if (description.length === 0) {
-        throw new Error(`Topic ${draft.id} has no description; a description is required to publish.`);
-    }
-    return {
-        id: draft.id,
-        title: draft.title,
-        description,
-        ...(draft.repos !== undefined ? { repos: draft.repos } : {}),
-        createdAt: draft.createdAt,
-        updatedAt: draft.updatedAt,
-        createdBy: projection.createdBy,
-        ...(draft.status !== undefined ? { status: draft.status } : {}),
-        visibility: projection.visibility,
-    };
-}
-exports.publishedFromDraft = publishedFromDraft;
 //# sourceMappingURL=topic-types.js.map

package/dist/storage/topic-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"topic-types.js","sourceRoot":"","sources":["../../src/storage/topic-types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AAuLH;;;;;;;;;;;;;;GAcG;AACH,SAAgB,kBAAkB,CAChC,KAAiB,EACjB,UAA6B;IAE7B,MAAM,WAAW,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACrD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE;QAC5B,MAAM,IAAI,KAAK,CAAC,SAAS,KAAK,CAAC,EAAE,4DAA4D,CAAC,CAAC;KAChG;IACD,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW;QACX,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,UAAU,EAAE,UAAU,CAAC,UAAU;KAClC,CAAC;AACJ,CAAC;AAnBD,gDAmBC"}
+{"version":3,"file":"topic-types.js","sourceRoot":"","sources":["../../src/storage/topic-types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG"}

package/dist/storage/topicStore.d.ts

@@ -23,7 +23,7 @@
  * (`migrateFromLegacyBlob`) — it is never run automatically on load; the desktop
  * triggers it from a Settings action.
  */
-import type { DraftTopic, TopicStatus } from './topic-types';
+import type { DraftTopic } from './topic-types';
 /** Root of the global, cross-repo principal narration store. */
 export declare const PRINCIPAL_DIR: string;
 /** File-per-topic directory. */
@@ -39,8 +39,6 @@ export interface TopicIndexEntry {
     id: string;
     title: string;
     descriptionPreview: string;
-    /** `status.state` lifted out for filtering/sorting without a file read. */
-    state?: TopicStatus['state'];
     createdAt: string;
     updatedAt: string;
     createdBy?: {
@@ -66,7 +64,7 @@ export interface MigrationResult {
  * Fields a caller may set when updating a topic. `id` and `createdAt` are set
  * once at creation and cannot be changed by an update.
  */
-export type TopicUpdate = Partial<Pick<DraftTopic, 'title' | 'description' | 'status' | 'createdBy' | 'assets' | 'repos' | 'subsystemModels'>>;
+export type TopicUpdate = Partial<Pick<DraftTopic, 'title' | 'description' | 'createdBy' | 'assets' | 'repos' | 'subsystemModels' | 'references'>>;
 /**
  * Fields a caller may set when creating a topic. `id`, `createdAt`,
  * `updatedAt` are filled in when omitted; passing `id` lets a caller control

package/dist/storage/topicStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"topicStore.d.ts","sourceRoot":"","sources":["../../src/storage/topicStore.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"topicStore.d.ts","sourceRoot":"","sources":["../../src/storage/topicStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,gEAAgE;AAChE,eAAO,MAAM,aAAa,QAAgC,CAAC;AAC3D,gCAAgC;AAChC,eAAO,MAAM,UAAU,QAAgC,CAAC;AACxD,wDAAwD;AACxD,eAAO,MAAM,kBAAkB,QAAgD,CAAC;AAKhF;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;CAClB;AA0CD,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,CAC/B,IAAI,CACF,UAAU,EACV,OAAO,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,iBAAiB,GAAG,YAAY,CAC9F,CACF,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,CAAC,GAAG;IAC7E,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,UAAU,CAAoC;IAEtD;;;;OAIG;gBACS,OAAO,GAAE,MAAmB,EAAE,cAAc,GAAE,MAA2B;IAQrF;;;;;;;;;OASG;IACG,SAAS,CAAC,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAUrE,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAOtD;;;;;OAKG;IACG,IAAI,CAAC,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAKrE,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAkBpD,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAclE,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAa/C;;;;;;;;;;OAUG;IACG,qBAAqB,IAAI,OAAO,CAAC,eAAe,CAAC;YAmEzC,QAAQ;YAQR,YAAY;IAQ1B,4EAA4E;YAC9D,UAAU;YAaV,SAAS;YAUT,cAAc;YAWd,UAAU;YASV,SAAS;IAkBvB,2EAA2E;YAC7D,YAAY;IA2B1B,OAAO,CAAC,YAAY;CAWrB"}

package/dist/storage/topicStore.js

@@ -54,7 +54,6 @@ const buildEntry = (topic, sizeBytes) => ({
     id: topic.id,
     title: topic.title || 'Untitled topic',
     descriptionPreview: descriptionPreview(topic.description),
-    state: topic.status?.state,
     createdAt: topic.createdAt,
     updatedAt: topic.updatedAt,
     createdBy: topic.createdBy,

package/dist/storage/topicStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"topicStore.js","sourceRoot":"","sources":["../../src/storage/topicStore.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"topicStore.js","sourceRoot":"","sources":["../../src/storage/topicStore.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@principal-ai/subsystems-core",
-  "version": "0.50.0",
+  "version": "0.51.1",
   "description": "Subsystem model types and agent-session tooling for Principal AI",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/src/index.ts

@@ -13,6 +13,15 @@
 
 export * from './types';
 
+export type {
+  DraftTopic,
+  TopicAsset,
+  TopicCreator,
+  TopicSubsystemModelRef,
+  TopicReference,
+} from './storage/topic-types';
+export { formatTopicReferenceLink, parseTopicReferenceLink } from './storage/topic-reference-links';
+
 // Cross-field validation (the rules the JSON Schema can't express). Structural
 // (schema) validation is enforced per surface against
 // `schemas/subsystem-model.schema.json`.

package/src/node.ts

@@ -22,16 +22,14 @@ export type {
   TopicUpdate,
   MigrationResult,
 } from './storage/topicStore';
-export { publishedFromDraft } from './storage/topic-types';
 export type {
   DraftTopic,
-  PublishedTopic,
-  PublishProjection,
-  TopicStatus,
   TopicAsset,
   TopicCreator,
   TopicSubsystemModelRef,
+  TopicReference,
 } from './storage/topic-types';
+export { formatTopicReferenceLink, parseTopicReferenceLink } from './storage/topic-reference-links';
 
 // OpenCode event retrieval (Node.js only - SQLite)
 export { OpenCodeEventStore, defaultOpenCodeDBPath } from './opencode/OpenCodeEventStore';

package/src/storage/topic-reference-links.test.ts

@@ -0,0 +1,47 @@
+import { describe, expect, test } from 'bun:test';
+import { formatTopicReferenceLink, parseTopicReferenceLink } from './topic-reference-links';
+import type { TopicReference } from './topic-types';
+
+describe('topic reference links', () => {
+  test('formats topic and C4 sketch links', () => {
+    expect(formatTopicReferenceLink({ kind: 'topic', topicId: 'topic-123-abc' }))
+      .toBe('principal://topic/topic-123-abc');
+    expect(formatTopicReferenceLink({ kind: 'c4-sketch', sketchId: 'c4s-123-abc' }))
+      .toBe('principal://c4-sketch/c4s-123-abc');
+  });
+
+  test('round-trips opaque ids and escapes Markdown delimiters', () => {
+    const references: TopicReference[] = [
+      { kind: 'topic', topicId: 'topic-123-abc' },
+      { kind: 'c4-sketch', sketchId: 'c4s-123-abc' },
+      { kind: 'topic', topicId: "topic-é(1)!'?#%" },
+      { kind: 'topic', topicId: 'topic-%2F' },
+    ];
+    for (const reference of references) {
+      const href = formatTopicReferenceLink(reference);
+      expect(href).not.toMatch(/[()!'?#]/);
+      expect(parseTopicReferenceLink(href)).toEqual(reference);
+    }
+  });
+
+  test('rejects invalid ids when formatting', () => {
+    for (const topicId of ['', '.', '..', 'a/b', 'a\\b', ' a', 'a b', 'a\n', 'a\u0000']) {
+      expect(() => formatTopicReferenceLink({ kind: 'topic', topicId })).toThrow();
+    }
+  });
+
+  test('returns null for unsupported or malformed hrefs', () => {
+    for (const href of [
+      '', 'https://example.com', 'pkg:github/acme/repo',
+      'principal://model/sg-1', 'principal://topic/', 'principal://topic',
+      'principal://topic/a/b', 'principal://topic/a/', 'principal://topic/a?q=1',
+      'principal://topic/a#heading', 'principal://topic/..', 'principal://topic/%2e%2e',
+      'principal://topic/%2F', 'principal://topic/%5C', 'principal://topic/%00',
+      'principal://topic/%20', 'principal://topic/a\n', 'principal://topic/%',
+      'principal://topic/%GG', 'principal://topic/%FF',
+      ' principal://topic/a', 'principal://topic@host/a',
+    ]) {
+      expect(parseTopicReferenceLink(href)).toBeNull();
+    }
+  });
+});

package/src/storage/topic-reference-links.ts

@@ -0,0 +1,38 @@
+import type { TopicReference } from './topic-types';
+
+// IDs are opaque single path segments, not paths. Decode exactly once and
+// reject traversal, separators, whitespace, and control characters.
+function isReferenceId(id: string): boolean {
+  return id.length > 0 && id !== '.' && id !== '..' && !/[/\\\s\u0000-\u001f\u007f]/.test(id);
+}
+
+/** Format a Markdown-safe href. Does not attach or resolve the target. */
+export function formatTopicReferenceLink(reference: TopicReference): string {
+  const id = reference.kind === 'topic' ? reference.topicId : reference.sketchId;
+  if (!isReferenceId(id)) throw new Error('Invalid topic reference id');
+  const encoded = encodeURIComponent(id).replace(
+    /[!'()*]/g,
+    (character) => `%${character.charCodeAt(0).toString(16).toUpperCase()}`,
+  );
+  return `principal://${reference.kind}/${encoded}`;
+}
+
+/**
+ * Parse a local topic/sketch href without I/O. Unknown kinds, malformed escapes,
+ * extra path segments, queries, and fragments return null. Target existence and
+ * navigation belong to the host. Parsing never creates an attachment.
+ */
+export function parseTopicReferenceLink(href: string): TopicReference | null {
+  const match = /^principal:\/\/(topic|c4-sketch)\/([^/?#]+)$/.exec(href);
+  if (!match) return null;
+  let id: string;
+  try {
+    id = decodeURIComponent(match[2]);
+  } catch {
+    return null;
+  }
+  if (!isReferenceId(id)) return null;
+  return match[1] === 'topic'
+    ? { kind: 'topic', topicId: id }
+    : { kind: 'c4-sketch', sketchId: id };
+}

package/src/storage/topic-types.ts

@@ -3,78 +3,25 @@
  * agrees on. Browser-safe (no `node:*`); the file-per-topic store that reads and
  * writes these lives in `./node` (see `topicStore.ts`).
  *
- * A **topic** is a locally authored subject brief that may be published. Two
- * distinct named shapes, split by id-namespace / ownership, with an explicit
- * translation between them — NOT one shared shape. Their `id` fields live in
- * different namespaces (local vs server), so passing one where the other is
- * expected corrupts topic identity.
+ * A **topic** is a locally authored subject brief. {@link DraftTopic} is the
+ * shape desktop persists to `~/.principal/topics/<id>.json` and edits.
  *
- * - {@link DraftTopic}     — locally-authored, what desktop persists + edits.
- * - {@link PublishedTopic} — server-authoritative, what the server returns and
- *                            mobile reads.
- * - {@link publishedFromDraft} — the Draft -> Published projection (one-way;
- *                            there is no reverse hydration).
- *
- * All timestamps are ISO 8601 strings because this contract crosses the
- * desktop/web boundary.
- */
-
-/**
- * Status of a topic — a small structured axis plus optional human nuance.
- *
- * `state` is the machine-meaningful signal (drives badge color, sorting, and
- * filtering). `label` is free-form text shown in place of the default per-state
- * label. `waitingOn` describes an external blocker and is meaningful when
- * `state` is `waiting`.
- *
- * The structured shape is deliberate: it lets automations check and resolve a
- * blocker without parsing prose — e.g. flip `waiting` -> `paused` once `until`
- * passes, or once a referenced PR merges.
+ * All timestamps are ISO 8601 strings.
  */
-export interface TopicStatus {
-  /**
-   * Structured lifecycle axis, ordered by a feature's "aliveness" from nascent
-   * to retired. Readers treat an absent OR unrecognized `state` as
-   * `new-thought`, so legacy topics and renamed values need no migration.
-   */
-  state:
-    'new-thought' | 'working' | 'paused' | 'waiting' | 'done-for-now' | 'deprecated' | 'abandoned';
-  /** Free-form text shown in place of the default label for the state. */
-  label?: string;
-  /** External blocker description. Meaningful when `state` is `waiting`. */
-  waitingOn?: {
-    /** Human description of the blocker, e.g. "design sign-off". */
-    note?: string;
-    /** ISO 8601 — when the hold is expected to lift. */
-    until?: string;
-    /** Structured pointer to the thing being waited on, for automations. */
-    ref?: {
-      kind: 'url' | 'pr' | 'issue' | 'topic';
-      /** The address/id of the referenced thing. */
-      value: string;
-      /** Optional human label for display. */
-      title?: string;
-    };
-  };
-}
 
 /**
  * An image attached to a topic — primarily a screenshot dragged into the
  * description. Bytes live on the topic (referenced from the description via an
  * `asset://<id>` markdown link), not inlined into the description string. A
  * render-time resolver swaps `asset://<id>` for `url` (preferred) or a data-URL
- * built from `data`, keeping a local (data-only) and a published (url-bearing)
- * topic interchangeable on read.
- *
- * Local-only on a {@link DraftTopic}: assets are uploaded/resolved at publish
- * time, so a {@link PublishedTopic} carries the resolved `url`, not raw `data`.
+ * built from `data`.
  */
 export interface TopicAsset {
   /** Content hash — free dedup and the stable `asset://` target. */
   id: string;
   /** MIME type, e.g. "image/png". */
   mime: string;
-  /** Base64-encoded bytes. Present locally and on publish. */
+  /** Base64-encoded bytes. */
   data?: string;
   /** Resolvable URL, when the bytes have been offloaded (e.g. to S3). */
   url?: string;
@@ -87,7 +34,7 @@ export interface TopicAsset {
 /**
  * GitHub identity of a topic's creator. Populated when a signed-in user
  * authors a topic; left undefined for local-only topics created before
- * sign-in. The server requires this on publish.
+ * sign-in.
  */
 export interface TopicCreator {
   githubId: number;
@@ -99,8 +46,8 @@ export interface TopicCreator {
  * specific runtime trails (flows) within that model.
  *
  * The link lives on the **topic** side, in the local store id namespace, and
- * never on the model: a subsystem-model document is a portable, host-free
- * artifact (shared/published) that must not embed local topic or store ids.
+ * never on the model: a subsystem-model document is a portable artifact that
+ * must not embed local topic or store ids.
  */
 export interface TopicSubsystemModelRef {
   /** Store-assigned model id, e.g. "sg-1781...". */
@@ -109,18 +56,22 @@ export interface TopicSubsystemModelRef {
   trailIds?: string[];
 }
 
+/**
+ * A directional, local-only reference owned by a topic. Targets remain separate
+ * artifacts; their contents and titles are resolved by the host, not copied here.
+ * Referencing a C4 sketch does not make its authored hypothesis evidence.
+ */
+export type TopicReference =
+  | { kind: 'c4-sketch'; sketchId: string }
+  | { kind: 'topic'; topicId: string };
+
 /**
  * Locally-authored topic — the shape desktop persists to
  * `~/.principal/topics/<id>.json` and edits.
  *
- * Local id namespace. `description` / `createdBy` are optional (a Draft may be
- * authored before sign-in). Carries local-only {@link TopicAsset}s
- * (`asset://<id>` screenshots, raw `data`). Has NO `visibility` — that's a
- * published concept.
- *
- * A Draft keeps existing after publish (it can be in a "published state"); its
- * link to the server identity lives in the desktop's `topics-sync.json`
- * sidecar, not in this shape.
+ * `description` / `createdBy` are optional (a Draft may be authored before
+ * sign-in). Carries local-only {@link TopicAsset}s (`asset://<id>` screenshots,
+ * raw `data`).
  */
 export interface DraftTopic {
   /** Unique identifier in the LOCAL id namespace. */
@@ -134,7 +85,7 @@ export interface DraftTopic {
    * `pkg:github/owner/repo`). The topic's own source of truth for "which repos"
    * — portable and machine-independent, matching `WorkspaceMembership.repositoryId`.
    * Machine-local clone paths stay a workspace-membership concern and never
-   * appear here, so this round-trips across machines on publish/fetch.
+   * appear here, so this round-trips across machines.
    */
   repos?: string[];
   /** ISO 8601. */
@@ -143,95 +94,17 @@ export interface DraftTopic {
   updatedAt: string;
   /** Creator identity; undefined for topics authored before sign-in. */
   createdBy?: TopicCreator;
-  /** Optional workflow status. Absent reads as `new-thought`. */
-  status?: TopicStatus;
   /** Local image attachments, referenced from the description via `asset://<id>`. */
   assets?: TopicAsset[];
   /**
-   * Subsystem models this topic concerns, as local store ids. Local-only: not
-   * carried on publish, since the referenced models are a local artifact.
+   * Subsystem models this topic concerns, as local store ids. Local-only, since
+   * the referenced models are a local artifact.
    */
   subsystemModels?: TopicSubsystemModelRef[];
-}
-
-/**
- * Server-authoritative topic — the shape the server returns and mobile reads.
- *
- * Remote id namespace. `description` / `createdBy` are required (publish is the
- * validation gate). Carries `visibility`; assets have been resolved to `url`s.
- *
- * CAVEAT: "Published" means "has a server identity", NOT "public" — a
- * PublishedTopic can be `visibility: 'private'`.
- */
-export interface PublishedTopic {
-  /** Unique identifier in the REMOTE (server) id namespace. */
-  id: string;
-  /** Display title. */
-  title: string;
-  /** Markdown body — required on the server. */
-  description: string;
   /**
-   * Repositories this topic is about, as PURL strings (e.g.
-   * `pkg:github/owner/repo`). Travels with the topic across the wire so a
-   * received shared topic carries its repos; preserved on publish/fetch.
+   * Attached topics and C4 sketches. Whole-array replacement on update; `[]`
+   * clears attachments. Independent of links in `description`: neither edits
+   * the other. Hosts validate target existence and reject self-references.
    */
-  repos?: string[];
-  /** ISO 8601. */
-  createdAt: string;
-  /** ISO 8601. */
-  updatedAt: string;
-  /** Creator identity — required on the server. */
-  createdBy: TopicCreator;
-  /** Optional workflow status, travels with the topic when published. */
-  status?: TopicStatus;
-  /** Server visibility. "private" is still a PublishedTopic. */
-  visibility: 'private' | 'public';
-}
-
-/**
- * Inputs the {@link DraftTopic} cannot supply on its own — the namespace
- * crossing and the fields publish must enforce. The caller resolves these
- * before projecting:
- * - `createdBy`: required on the server; supplied here if the draft lacks it.
- * - `visibility`: a published concept the draft never carries.
- */
-export interface PublishProjection {
-  createdBy: TopicCreator;
-  visibility: 'private' | 'public';
-}
-
-/**
- * Project a {@link DraftTopic} into a {@link PublishedTopic} — the one-way
- * Draft -> Published translation. It does NOT perform any I/O (no id minting,
- * no asset upload, no network): the caller resolves the namespace-crossing and
- * required fields into {@link PublishProjection} first (uploading assets,
- * choosing visibility), and this enforces the shape.
- *
- * One-way by design: there is no reverse `PublishedTopic -> DraftTopic`
- * hydration. A published topic's edits write through to the server; the local
- * Draft is reconciled from the server's response field-by-field, never by
- * rebuilding a Draft from a Published shape.
- *
- * Throws if `description` is empty — publish is also the validation gate, and
- * the server rejects a description-less topic.
- */
-export function publishedFromDraft(
-  draft: DraftTopic,
-  projection: PublishProjection
-): PublishedTopic {
-  const description = (draft.description ?? '').trim();
-  if (description.length === 0) {
-    throw new Error(`Topic ${draft.id} has no description; a description is required to publish.`);
-  }
-  return {
-    id: draft.id,
-    title: draft.title,
-    description,
-    ...(draft.repos !== undefined ? { repos: draft.repos } : {}),
-    createdAt: draft.createdAt,
-    updatedAt: draft.updatedAt,
-    createdBy: projection.createdBy,
-    ...(draft.status !== undefined ? { status: draft.status } : {}),
-    visibility: projection.visibility,
-  };
+  references?: TopicReference[];
 }

package/src/storage/topicStore.test.ts

@@ -7,7 +7,7 @@ import { mkdtempSync, rmSync, writeFileSync, existsSync, readFileSync } from 'fs
 import { tmpdir } from 'os';
 import { join } from 'path';
 import { TopicStore } from './topicStore';
-import { publishedFromDraft, type DraftTopic } from './topic-types';
+import type { TopicReference } from './topic-types';
 
 let dir: string;
 let topicsDir: string;
@@ -74,26 +74,6 @@ describe('CRUD', () => {
     expect(updated.repos).toEqual(['pkg:github/acme/web', 'pkg:github/acme/api']);
   });
 
-  test('publishedFromDraft carries repos through the projection', () => {
-    const draft: DraftTopic = {
-      id: 'topic-pub',
-      title: 'Pub',
-      description: 'has a description',
-      repos: ['pkg:github/acme/web'],
-      subsystemModels: [{ modelId: 'sg-1-abc', trailIds: ['trail-a'] }],
-      createdAt: '2026-01-01T00:00:00.000Z',
-      updatedAt: '2026-01-02T00:00:00.000Z',
-    };
-    const published = publishedFromDraft(draft, {
-      createdBy: { githubId: 1, githubLogin: 'u1' },
-      visibility: 'private',
-    });
-    expect(published.repos).toEqual(['pkg:github/acme/web']);
-    expect(published).not.toHaveProperty('trailIds');
-    // Local-only model refs must not travel on publish.
-    expect(published).not.toHaveProperty('subsystemModels');
-  });
-
   test('subsystemModels persist on create and are updatable', async () => {
     const store = makeStore();
     const created = await store.createTopic({
@@ -112,6 +92,56 @@ describe('CRUD', () => {
     expect(updated.subsystemModels).toEqual([{ modelId: 'sg-2-def' }]);
   });
 
+  test('references survive fresh reads and unrelated updates, and can be replaced or cleared', async () => {
+    const store = makeStore();
+    const references: TopicReference[] = [
+      { kind: 'c4-sketch', sketchId: 'c4s-1-abc' },
+      { kind: 'topic', topicId: 'topic-related' },
+    ];
+    const created = await store.createTopic({
+      id: 'topic-refs',
+      title: 'Architecture',
+      description: '[Related](principal://topic/topic-related)',
+      subsystemModels: [{ modelId: 'sg-1-abc' }],
+      references,
+    });
+    expect(created.references).toEqual(references);
+    expect((await makeStore().getTopic(created.id))?.references).toEqual(references);
+
+    await store.updateTopic(created.id, { title: 'Renamed' });
+    expect((await makeStore().getTopic(created.id))?.references).toEqual(references);
+
+    const replacement: TopicReference[] = [{ kind: 'topic', topicId: 'topic-other' }];
+    await store.updateTopic(created.id, { references: replacement });
+    expect((await makeStore().getTopic(created.id))?.references).toEqual(replacement);
+
+    await store.updateTopic(created.id, { references: [] });
+    expect(await makeStore().getTopic(created.id)).toMatchObject({
+      references: [],
+      description: created.description,
+      subsystemModels: created.subsystemModels,
+    });
+  });
+
+  test('existing topics need no references migration', async () => {
+    const store = makeStore();
+    const topic = await store.createTopic({ title: 'Without attachments' });
+    expect(topic).not.toHaveProperty('references');
+    await store.updateTopic(topic.id, { description: 'Still without attachments' });
+    expect(await makeStore().getTopic(topic.id)).not.toHaveProperty('references');
+  });
+
+  test('deleting a referenced topic preserves the attachment for missing-target display', async () => {
+    const store = makeStore();
+    const target = await store.createTopic({ title: 'Target' });
+    const owner = await store.createTopic({
+      title: 'Owner',
+      references: [{ kind: 'topic', topicId: target.id }],
+    });
+    await store.deleteTopic(target.id);
+    expect((await makeStore().getTopic(owner.id))?.references).toEqual(owner.references);
+  });
+
   test('delete removes the file and the index entry', async () => {
     const store = makeStore();
     await store.createTopic({ id: 'topic-d', title: 'D' });
@@ -176,33 +206,6 @@ describe('index rebuild', () => {
       'topic-external',
     );
   });
-
-  test('legacy topic files preserve unknown fields verbatim', async () => {
-    const store = makeStore();
-    await store.createTopic({
-      id: 'topic-legacy',
-      title: 'Legacy',
-      repos: ['pkg:github/a/b'],
-    });
-    const topicPath = join(topicsDir, 'topic-legacy.json');
-    const legacy = {
-      ...JSON.parse(readFileSync(topicPath, 'utf8')),
-      trailIds: ['old-trail'],
-      description: 'Keep this description',
-    };
-    writeFileSync(topicPath, JSON.stringify(legacy), 'utf8');
-
-    const loaded = await store.getTopic('topic-legacy');
-
-    expect(loaded).toMatchObject({
-      id: 'topic-legacy',
-      title: 'Legacy',
-      description: 'Keep this description',
-      repos: ['pkg:github/a/b'],
-    });
-    expect(loaded).toHaveProperty('trailIds', ['old-trail']);
-    expect(JSON.parse(readFileSync(topicPath, 'utf8'))).toHaveProperty('trailIds', ['old-trail']);
-  });
 });
 
 describe('migration', () => {

package/src/storage/topicStore.ts

@@ -27,7 +27,7 @@
 import { homedir } from 'node:os';
 import { dirname, join } from 'node:path';
 import { mkdir, readFile, writeFile, unlink, readdir, rename, access } from 'node:fs/promises';
-import type { DraftTopic, TopicStatus } from './topic-types';
+import type { DraftTopic } from './topic-types';
 
 /** Root of the global, cross-repo principal narration store. */
 export const PRINCIPAL_DIR = join(homedir(), '.principal');
@@ -48,8 +48,6 @@ export interface TopicIndexEntry {
   id: string;
   title: string;
   descriptionPreview: string;
-  /** `status.state` lifted out for filtering/sorting without a file read. */
-  state?: TopicStatus['state'];
   createdAt: string;
   updatedAt: string;
   createdBy?: { githubId: number; githubLogin: string };
@@ -85,7 +83,6 @@ const buildEntry = (topic: DraftTopic, sizeBytes: number): TopicIndexEntry => ({
   id: topic.id,
   title: topic.title || 'Untitled topic',
   descriptionPreview: descriptionPreview(topic.description),
-  state: topic.status?.state,
   createdAt: topic.createdAt,
   updatedAt: topic.updatedAt,
   createdBy: topic.createdBy,
@@ -118,7 +115,7 @@ export interface MigrationResult {
 export type TopicUpdate = Partial<
   Pick<
     DraftTopic,
-    'title' | 'description' | 'status' | 'createdBy' | 'assets' | 'repos' | 'subsystemModels'
+    'title' | 'description' | 'createdBy' | 'assets' | 'repos' | 'subsystemModels' | 'references'
   >
 >;