@ai-agent-forge/plugin-alignment 0.88.1

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Data model of the alignment capability plugin\n * (`docs/design/需求对齐插件设计.md` §4). This module declares shapes only —\n * every conversion rule lives in `engine.ts` and every host-facing side effect\n * (entries, events, injection, HTTP) lives in `index.ts` / `http-server.ts`.\n */\n\n/** The three funnel steps, in canonical order. */\nexport const STEP_ORDER = [\"objective\", \"detail\", \"design\"] as const;\n\nexport type AlignmentStepId = (typeof STEP_ORDER)[number];\n\nexport type AlignmentBlockKind = \"fact\" | \"assumption\" | \"decision\" | \"missing\";\n\nexport type AlignmentCommentAuthor = \"user\" | \"assistant\";\n\nexport type AlignmentCommentResolutionKind = \"answered\" | \"dismissed\" | \"incorporated\";\n\n/** Bidirectional block annotation (设计 §4: author distinguishes the direction). */\nexport interface AlignmentComment {\n\tid: string; // unique within the owning block\n\tauthor: AlignmentCommentAuthor;\n\t/** Exact in-block quote; required for user comments, optional for assistant ones. */\n\tquote?: string;\n\tnote: string;\n\t/** User flag: the objection targets an earlier (upstream) step — retreat candidate. */\n\tescalate?: boolean;\n\tstatus: \"open\" | \"resolved\";\n\tresolution?: {\n\t\tkind: AlignmentCommentResolutionKind;\n\t\ttext?: string;\n\t\tround?: number;\n\t};\n\tcreatedAtRound: number;\n}\n\nexport interface AlignmentBlock {\n\tid: string; // stable within the step\n\tkind: AlignmentBlockKind;\n\tcontent: string;\n\trationale?: string;\n\timpact?: string[];\n\tstatus: \"pending\" | \"approved\";\n\t/** Engine-computed fingerprint (kind+content+rationale+impact); cross-round approval inheritance key. */\n\tcontentHash: string;\n\t/** Round in which the content last changed; drives the \"modified this round\" badge. */\n\tmodifiedInRound?: number;\n\t/** Stored fill-in for a missing block — the user's own words, kept verbatim until the model restructures the block. */\n\tdraftAnswer?: string;\n\tcomments: AlignmentComment[];\n}\n\nexport interface AlignmentStepState {\n\tstep: AlignmentStepId;\n\t/** pending = not unlocked yet (terminal-audit D2); reset = retreated into, confirmations cleared. */\n\tstatus: \"pending\" | \"locked\" | \"active\" | \"reset\";\n\t/** Round count at confirmation time (entry-sequence-like anchor, not wall clock). */\n\tbaselineConfirmedAtRound?: number;\n\tblocks: AlignmentBlock[];\n}\n\nexport interface AlignmentRecord {\n\tid: string;\n\ttitle: string;\n\t/** Soft reference to goal.state (advisory, #10): dangling only warns. */\n\tgoalId?: string;\n\t/**\n\t * Created-as-aligning (no draft state, terminal audit D3). `finalizing`\n\t * (走查 2026-10-03) = all three steps locked, waiting for the final\n\t * review tab confirmation — only that confirmation completes the\n\t * alignment and writes the baseline (方案确认 ≠ 终版确认).\n\t */\n\tstatus: \"aligning\" | \"finalizing\" | \"completed\" | \"cancelled\";\n\t/**\n\t * Monotonic for alignment_set callers; engine-triggered conversions\n\t * (freeze/unlock/retreat/complete) auto-increment it too (workflow\n\t * precedent, terminal audit D4). Carried on round results so the model\n\t * always knows the next acceptable revision.\n\t */\n\trevision: number;\n\t/** Points at the single step with status \"active\"; pending/reset/locked steps are not writable. */\n\tactiveStep: AlignmentStepId;\n\tsteps: AlignmentStepState[]; // fixed three elements in STEP_ORDER\n\t/** Cumulative feedback rounds across all steps. */\n\troundCount: number;\n\t/**\n\t * Additions submitted from the page but not yet structured into blocks by\n\t * the model — the server-side truth of gate condition three (terminal\n\t * audit D7). Cleared by the next alignment_set on the active step.\n\t */\n\tpendingFeedback?: { round: number; additions: string[] };\n\t/**\n\t * Historical version snapshots (走查 2026-10-03): the active-step block\n\t * set archived before each revisoning `alignment_set`. Append-only with\n\t * bounded rolling; the page renders them read-only — only the latest\n\t * version accepts approvals/comments/answers.\n\t */\n\tversions?: AlignmentVersionSnapshot[];\n}\n\nexport interface AlignmentState {\n\talignments: AlignmentRecord[];\n}\n\nexport type AlignmentTransitionEvent =\n\t| \"round.submitted\"\n\t| \"round.delivered\"\n\t| \"step.confirmed\"\n\t| \"step.retreated\"\n\t| \"design.locked\" // 方案锁定、进入终审总览（走查 2026-10-03）\n\t| \"version.rolled-back\" // 步内版本回退（走查 2026-10-03）\n\t| \"alignment.cancelled\"\n\t| \"alignment.completed\";\n\n/** Append-only audit entry: one per user round, confirmation, retreat, cancel, completion. */\nexport interface AlignmentTransitionEntry {\n\talignmentId: string;\n\tstep?: AlignmentStepId; // alignment-level transitions carry no step\n\tevent: AlignmentTransitionEvent;\n\tround?: number;\n\treason: { code: string; detail?: string };\n\t/** Anchors the adjacent alignment.state snapshot. */\n\trevision: number;\n}\n\n/** A user comment submitted from the page (§5 round flow 3). */\nexport interface RoundPostComment {\n\tblockId: string;\n\tquote: string;\n\tnote: string;\n\tescalate?: boolean;\n}\n\n/** A reply to an assistant comment (answer/dismiss are mutually exclusive). */\nexport interface RoundPostCommentReply {\n\tcommentId: string;\n\tblockId: string;\n\tanswer?: string;\n\tdismiss?: boolean;\n}\n\n/** An answer to a missing-block fill-in. */\nexport interface RoundPostAnswer {\n\tblockId: string;\n\tvalue: string;\n}\n\n/** POST /round body (§5 round flow 3; baseRevision is the anti-staleness gate, terminal audit D6). */\nexport interface AlignmentRoundPost {\n\tbaseRevision: number;\n\t/**\n\t * Page-driven action (走查 2026-10-03): default `feedback`; `retreat`\n\t * rolls the task back to an earlier locked step (`targetStep`, downstream\n\t * steps are discarded); `rollback` restores an archived version of the\n\t * active step (`targetRevision`, step-scoped, comments survive).\n\t */\n\taction?: \"feedback\" | \"retreat\" | \"rollback\";\n\ttargetStep?: AlignmentStepId;\n\ttargetRevision?: number;\n\t/** Full approved-block id set of the active step (server mirrors the page). */\n\tapprovals: string[];\n\tcomments: RoundPostComment[];\n\tcommentReplies: RoundPostCommentReply[];\n\tanswers: RoundPostAnswer[];\n\tadditions: string[];\n\tstepConfirmed: boolean;\n}\n\n/** Structured feedback injected into the session after a user round (§5 round flow 3). */\nexport interface AlignmentRoundResult {\n\talignmentId: string;\n\tround: number;\n\tstep: AlignmentStepId;\n\trevision: number;\n\tapprovals: string[];\n\tcomments: RoundPostComment[];\n\tcommentReplies: RoundPostCommentReply[];\n\tanswers: RoundPostAnswer[];\n\tadditions: string[];\n\tstepConfirmed: boolean;\n\t/** Present when the whole alignment completed with this round (design step confirmed). */\n\tfinalBaseline?: { step: AlignmentStepId; kind: AlignmentBlockKind; id: string; line: string }[];\n\tbaselineFilePath?: string;\n}\n\n/** Why a block still needs attention — drives the page spotlight and `/alignment why`. */\nexport interface PendingItem {\n\tblockId: string;\n\treason: \"unapproved\" | \"missing-empty\" | \"assistant-question-open\";\n}\n\n/** Gate facts (总则 2): three server-checkable conditions plus pending items. */\nexport interface GateSnapshot {\n\tunapproved: number;\n\topenComments: number;\n\tpendingAdditions: number;\n\tallGreen: boolean;\n\tpending: PendingItem[];\n}\n\n/** Error codes thrown by the engine; index.ts lets them surface as tool errors verbatim. */\nexport type AlignmentErrorCode =\n\t| \"invalid-id\"\n\t| \"active-alignment-exists\"\n\t| \"not-found\"\n\t| \"terminal-state\"\n\t| \"stale-revision\"\n\t| \"stale-state\"\n\t| \"step-not-writable\"\n\t| \"step-not-unlocked\"\n\t| \"block-has-open-comments\"\n\t| \"comment-ownership\"\n\t| \"comment-quote-mismatch\"\n\t| \"gate-not-satisfied\"\n\t| \"confirmed-with-feedback\"\n\t| \"invalid-block\"\n\t| \"invalid-comment\"\n\t| \"invalid-input\"\n\t| \"retreat-target-invalid\";\n\nexport class AlignmentError extends Error {\n\treadonly code: AlignmentErrorCode;\n\n\tconstructor(code: AlignmentErrorCode, message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"AlignmentError\";\n\t\tthis.code = code;\n\t}\n}\n\n/** Hard bounds (设计 §4 有界性): alignment state enters session entries, keep it bounded. */\n/** Archived pre-revision step block set; the page views these read-only. */\nexport interface AlignmentVersionSnapshot {\n\t/** Revision at archive time — the version's anchor. */\n\trevision: number;\n\t/** Round at archive time. */\n\tround: number;\n\t/** Which step's block set was archived. */\n\tstep: AlignmentStepId;\n\t/** Full archived block set (rendered read-only). */\n\tblocks: AlignmentBlock[];\n\t/** Set when the block set exceeded the per-snapshot size budget. */\n\ttruncated?: true;\n}\n\nexport const ALIGNMENT_LIMITS = {\n\tcontentMaxLength: 8192,\n\trationaleMaxLength: 2048,\n\tnotesPerBlockMax: 50,\n\tnoteMaxLength: 2048,\n\tblocksPerStepMax: 300,\n\t/** Rolling retention for version snapshots (走查 2026-10-03). */\n\tversionsMax: 10,\n\t/** Per-snapshot serialization budget; over this only the anchor is kept. */\n\tversionsSnapshotMaxBytes: 262_144,\n\tadditionMaxLength: 4096,\n\tanswerMaxLength: 4096,\n} as const;\n"]}

package/dist/types.js

@@ -0,0 +1,30 @@
+/**
+ * Data model of the alignment capability plugin
+ * (`docs/design/需求对齐插件设计.md` §4). This module declares shapes only —
+ * every conversion rule lives in `engine.ts` and every host-facing side effect
+ * (entries, events, injection, HTTP) lives in `index.ts` / `http-server.ts`.
+ */
+/** The three funnel steps, in canonical order. */
+export const STEP_ORDER = ["objective", "detail", "design"];
+export class AlignmentError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "AlignmentError";
+        this.code = code;
+    }
+}
+export const ALIGNMENT_LIMITS = {
+    contentMaxLength: 8192,
+    rationaleMaxLength: 2048,
+    notesPerBlockMax: 50,
+    noteMaxLength: 2048,
+    blocksPerStepMax: 300,
+    /** Rolling retention for version snapshots (走查 2026-10-03). */
+    versionsMax: 10,
+    /** Per-snapshot serialization budget; over this only the anchor is kept. */
+    versionsSnapshotMaxBytes: 262_144,
+    additionMaxLength: 4096,
+    answerMaxLength: 4096,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,kDAAkD;AAClD,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAoNrE,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC/B,IAAI,CAAqB;IAElC,YAAY,IAAwB,EAAE,OAAe,EAAE;QACtD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IAAA,CACjB;CACD;AAiBD,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC/B,gBAAgB,EAAE,IAAI;IACtB,kBAAkB,EAAE,IAAI;IACxB,gBAAgB,EAAE,EAAE;IACpB,aAAa,EAAE,IAAI;IACnB,gBAAgB,EAAE,GAAG;IACrB,mEAA+D;IAC/D,WAAW,EAAE,EAAE;IACf,4EAA4E;IAC5E,wBAAwB,EAAE,OAAO;IACjC,iBAAiB,EAAE,IAAI;IACvB,eAAe,EAAE,IAAI;CACZ,CAAC","sourcesContent":["/**\n * Data model of the alignment capability plugin\n * (`docs/design/需求对齐插件设计.md` §4). This module declares shapes only —\n * every conversion rule lives in `engine.ts` and every host-facing side effect\n * (entries, events, injection, HTTP) lives in `index.ts` / `http-server.ts`.\n */\n\n/** The three funnel steps, in canonical order. */\nexport const STEP_ORDER = [\"objective\", \"detail\", \"design\"] as const;\n\nexport type AlignmentStepId = (typeof STEP_ORDER)[number];\n\nexport type AlignmentBlockKind = \"fact\" | \"assumption\" | \"decision\" | \"missing\";\n\nexport type AlignmentCommentAuthor = \"user\" | \"assistant\";\n\nexport type AlignmentCommentResolutionKind = \"answered\" | \"dismissed\" | \"incorporated\";\n\n/** Bidirectional block annotation (设计 §4: author distinguishes the direction). */\nexport interface AlignmentComment {\n\tid: string; // unique within the owning block\n\tauthor: AlignmentCommentAuthor;\n\t/** Exact in-block quote; required for user comments, optional for assistant ones. */\n\tquote?: string;\n\tnote: string;\n\t/** User flag: the objection targets an earlier (upstream) step — retreat candidate. */\n\tescalate?: boolean;\n\tstatus: \"open\" | \"resolved\";\n\tresolution?: {\n\t\tkind: AlignmentCommentResolutionKind;\n\t\ttext?: string;\n\t\tround?: number;\n\t};\n\tcreatedAtRound: number;\n}\n\nexport interface AlignmentBlock {\n\tid: string; // stable within the step\n\tkind: AlignmentBlockKind;\n\tcontent: string;\n\trationale?: string;\n\timpact?: string[];\n\tstatus: \"pending\" | \"approved\";\n\t/** Engine-computed fingerprint (kind+content+rationale+impact); cross-round approval inheritance key. */\n\tcontentHash: string;\n\t/** Round in which the content last changed; drives the \"modified this round\" badge. */\n\tmodifiedInRound?: number;\n\t/** Stored fill-in for a missing block — the user's own words, kept verbatim until the model restructures the block. */\n\tdraftAnswer?: string;\n\tcomments: AlignmentComment[];\n}\n\nexport interface AlignmentStepState {\n\tstep: AlignmentStepId;\n\t/** pending = not unlocked yet (terminal-audit D2); reset = retreated into, confirmations cleared. */\n\tstatus: \"pending\" | \"locked\" | \"active\" | \"reset\";\n\t/** Round count at confirmation time (entry-sequence-like anchor, not wall clock). */\n\tbaselineConfirmedAtRound?: number;\n\tblocks: AlignmentBlock[];\n}\n\nexport interface AlignmentRecord {\n\tid: string;\n\ttitle: string;\n\t/** Soft reference to goal.state (advisory, #10): dangling only warns. */\n\tgoalId?: string;\n\t/**\n\t * Created-as-aligning (no draft state, terminal audit D3). `finalizing`\n\t * (走查 2026-10-03) = all three steps locked, waiting for the final\n\t * review tab confirmation — only that confirmation completes the\n\t * alignment and writes the baseline (方案确认 ≠ 终版确认).\n\t */\n\tstatus: \"aligning\" | \"finalizing\" | \"completed\" | \"cancelled\";\n\t/**\n\t * Monotonic for alignment_set callers; engine-triggered conversions\n\t * (freeze/unlock/retreat/complete) auto-increment it too (workflow\n\t * precedent, terminal audit D4). Carried on round results so the model\n\t * always knows the next acceptable revision.\n\t */\n\trevision: number;\n\t/** Points at the single step with status \"active\"; pending/reset/locked steps are not writable. */\n\tactiveStep: AlignmentStepId;\n\tsteps: AlignmentStepState[]; // fixed three elements in STEP_ORDER\n\t/** Cumulative feedback rounds across all steps. */\n\troundCount: number;\n\t/**\n\t * Additions submitted from the page but not yet structured into blocks by\n\t * the model — the server-side truth of gate condition three (terminal\n\t * audit D7). Cleared by the next alignment_set on the active step.\n\t */\n\tpendingFeedback?: { round: number; additions: string[] };\n\t/**\n\t * Historical version snapshots (走查 2026-10-03): the active-step block\n\t * set archived before each revisoning `alignment_set`. Append-only with\n\t * bounded rolling; the page renders them read-only — only the latest\n\t * version accepts approvals/comments/answers.\n\t */\n\tversions?: AlignmentVersionSnapshot[];\n}\n\nexport interface AlignmentState {\n\talignments: AlignmentRecord[];\n}\n\nexport type AlignmentTransitionEvent =\n\t| \"round.submitted\"\n\t| \"round.delivered\"\n\t| \"step.confirmed\"\n\t| \"step.retreated\"\n\t| \"design.locked\" // 方案锁定、进入终审总览（走查 2026-10-03）\n\t| \"version.rolled-back\" // 步内版本回退（走查 2026-10-03）\n\t| \"alignment.cancelled\"\n\t| \"alignment.completed\";\n\n/** Append-only audit entry: one per user round, confirmation, retreat, cancel, completion. */\nexport interface AlignmentTransitionEntry {\n\talignmentId: string;\n\tstep?: AlignmentStepId; // alignment-level transitions carry no step\n\tevent: AlignmentTransitionEvent;\n\tround?: number;\n\treason: { code: string; detail?: string };\n\t/** Anchors the adjacent alignment.state snapshot. */\n\trevision: number;\n}\n\n/** A user comment submitted from the page (§5 round flow 3). */\nexport interface RoundPostComment {\n\tblockId: string;\n\tquote: string;\n\tnote: string;\n\tescalate?: boolean;\n}\n\n/** A reply to an assistant comment (answer/dismiss are mutually exclusive). */\nexport interface RoundPostCommentReply {\n\tcommentId: string;\n\tblockId: string;\n\tanswer?: string;\n\tdismiss?: boolean;\n}\n\n/** An answer to a missing-block fill-in. */\nexport interface RoundPostAnswer {\n\tblockId: string;\n\tvalue: string;\n}\n\n/** POST /round body (§5 round flow 3; baseRevision is the anti-staleness gate, terminal audit D6). */\nexport interface AlignmentRoundPost {\n\tbaseRevision: number;\n\t/**\n\t * Page-driven action (走查 2026-10-03): default `feedback`; `retreat`\n\t * rolls the task back to an earlier locked step (`targetStep`, downstream\n\t * steps are discarded); `rollback` restores an archived version of the\n\t * active step (`targetRevision`, step-scoped, comments survive).\n\t */\n\taction?: \"feedback\" | \"retreat\" | \"rollback\";\n\ttargetStep?: AlignmentStepId;\n\ttargetRevision?: number;\n\t/** Full approved-block id set of the active step (server mirrors the page). */\n\tapprovals: string[];\n\tcomments: RoundPostComment[];\n\tcommentReplies: RoundPostCommentReply[];\n\tanswers: RoundPostAnswer[];\n\tadditions: string[];\n\tstepConfirmed: boolean;\n}\n\n/** Structured feedback injected into the session after a user round (§5 round flow 3). */\nexport interface AlignmentRoundResult {\n\talignmentId: string;\n\tround: number;\n\tstep: AlignmentStepId;\n\trevision: number;\n\tapprovals: string[];\n\tcomments: RoundPostComment[];\n\tcommentReplies: RoundPostCommentReply[];\n\tanswers: RoundPostAnswer[];\n\tadditions: string[];\n\tstepConfirmed: boolean;\n\t/** Present when the whole alignment completed with this round (design step confirmed). */\n\tfinalBaseline?: { step: AlignmentStepId; kind: AlignmentBlockKind; id: string; line: string }[];\n\tbaselineFilePath?: string;\n}\n\n/** Why a block still needs attention — drives the page spotlight and `/alignment why`. */\nexport interface PendingItem {\n\tblockId: string;\n\treason: \"unapproved\" | \"missing-empty\" | \"assistant-question-open\";\n}\n\n/** Gate facts (总则 2): three server-checkable conditions plus pending items. */\nexport interface GateSnapshot {\n\tunapproved: number;\n\topenComments: number;\n\tpendingAdditions: number;\n\tallGreen: boolean;\n\tpending: PendingItem[];\n}\n\n/** Error codes thrown by the engine; index.ts lets them surface as tool errors verbatim. */\nexport type AlignmentErrorCode =\n\t| \"invalid-id\"\n\t| \"active-alignment-exists\"\n\t| \"not-found\"\n\t| \"terminal-state\"\n\t| \"stale-revision\"\n\t| \"stale-state\"\n\t| \"step-not-writable\"\n\t| \"step-not-unlocked\"\n\t| \"block-has-open-comments\"\n\t| \"comment-ownership\"\n\t| \"comment-quote-mismatch\"\n\t| \"gate-not-satisfied\"\n\t| \"confirmed-with-feedback\"\n\t| \"invalid-block\"\n\t| \"invalid-comment\"\n\t| \"invalid-input\"\n\t| \"retreat-target-invalid\";\n\nexport class AlignmentError extends Error {\n\treadonly code: AlignmentErrorCode;\n\n\tconstructor(code: AlignmentErrorCode, message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"AlignmentError\";\n\t\tthis.code = code;\n\t}\n}\n\n/** Hard bounds (设计 §4 有界性): alignment state enters session entries, keep it bounded. */\n/** Archived pre-revision step block set; the page views these read-only. */\nexport interface AlignmentVersionSnapshot {\n\t/** Revision at archive time — the version's anchor. */\n\trevision: number;\n\t/** Round at archive time. */\n\tround: number;\n\t/** Which step's block set was archived. */\n\tstep: AlignmentStepId;\n\t/** Full archived block set (rendered read-only). */\n\tblocks: AlignmentBlock[];\n\t/** Set when the block set exceeded the per-snapshot size budget. */\n\ttruncated?: true;\n}\n\nexport const ALIGNMENT_LIMITS = {\n\tcontentMaxLength: 8192,\n\trationaleMaxLength: 2048,\n\tnotesPerBlockMax: 50,\n\tnoteMaxLength: 2048,\n\tblocksPerStepMax: 300,\n\t/** Rolling retention for version snapshots (走查 2026-10-03). */\n\tversionsMax: 10,\n\t/** Per-snapshot serialization budget; over this only the anchor is kept. */\n\tversionsSnapshotMaxBytes: 262_144,\n\tadditionMaxLength: 4096,\n\tanswerMaxLength: 4096,\n} as const;\n"]}

package/package.json

@@ -0,0 +1,53 @@
+{
+	"name": "@ai-agent-forge/plugin-alignment",
+	"version": "0.88.1",
+	"description": "Alignment capability plugin for Agent Forge (three-step requirement alignment funnel with an HTML confirmation page)",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist",
+		"agent-forge.json",
+		"plugin.json",
+		"README.md"
+	],
+	"scripts": {
+		"clean": "shx rm -rf dist",
+		"build": "tsgo -p tsconfig.build.json",
+		"test": "vitest --run",
+		"prepublishOnly": "npm run clean && npm run build"
+	},
+	"keywords": [
+		"agent-forge",
+		"plugin",
+		"alignment"
+	],
+	"author": "Agent Forge contributors",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/agent-forge/agent-forge.git",
+		"directory": "plugins/alignment"
+	},
+	"bugs": {
+		"url": "https://github.com/agent-forge/agent-forge/issues"
+	},
+	"homepage": "https://github.com/agent-forge/agent-forge#readme",
+	"engines": {
+		"node": ">=22.19.0"
+	},
+	"dependencies": {
+		"typebox": "1.3.27",
+		"@ai-agent-forge/plugin-sdk": "^0.88.1"
+	},
+	"devDependencies": {
+		"shx": "0.4.0",
+		"vitest": "4.1.11"
+	}
+}

package/plugin.json

@@ -0,0 +1,12 @@
+{
+	"id": "agent-forge.plugin.alignment",
+	"version": "0.88.1",
+	"apiVersion": "1-draft",
+	"entry": "./dist/entry.js",
+	"hostVersion": ">=0.84.4",
+	"requiredCapabilities": [
+		"session",
+		"events",
+		"tools"
+	]
+}