@planu/cli 0.63.7 → 0.64.1

package/dist/types/spec/repair.d.ts

@@ -0,0 +1,33 @@
+/** Categories of fixes that the repair engine can apply. */
+export type RepairFixType = 'frontmatter-malformed' | 'frontmatter-missing-field' | 'ac-vague' | 'section-missing' | 'cross-reference-broken' | 'tags-missing' | 'ac-format';
+/** A single fix applied (or proposed) by the repair engine. */
+export interface RepairFix {
+    /** Fix category. */
+    type: RepairFixType;
+    /** Human-readable description of what was fixed. */
+    description: string;
+    /** Original text before fix (empty string if inserted). */
+    before: string;
+    /** Replacement text after fix. */
+    after: string;
+    /** 1-based line number where the issue was detected (0 if N/A). */
+    line: number;
+}
+/** Result returned by repairSpec(). */
+export interface RepairResult {
+    /** List of all fixes detected (applied or proposed). */
+    fixes: RepairFix[];
+    /** Spec content with all fixes applied. Same as input when dryRun=true or no fixes needed. */
+    repairedContent: string;
+    /** Total number of fixes applied. */
+    fixCount: number;
+    /** Whether the repair was a dry run (no writes performed). */
+    dryRun: boolean;
+}
+/** Input args for the repair_spec tool. */
+export interface RepairSpecArgs {
+    projectId: string;
+    specId: string;
+    dryRun?: boolean;
+}
+//# sourceMappingURL=repair.d.ts.map

package/dist/types/spec/repair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair.d.ts","sourceRoot":"","sources":["../../../src/types/spec/repair.ts"],"names":[],"mappings":"AAEA,4DAA4D;AAC5D,MAAM,MAAM,aAAa,GACrB,uBAAuB,GACvB,2BAA2B,GAC3B,UAAU,GACV,iBAAiB,GACjB,wBAAwB,GACxB,cAAc,GACd,WAAW,CAAC;AAEhB,+DAA+D;AAC/D,MAAM,WAAW,SAAS;IACxB,oBAAoB;IACpB,IAAI,EAAE,aAAa,CAAC;IACpB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,uCAAuC;AACvC,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,8FAA8F;IAC9F,eAAe,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,2CAA2C;AAC3C,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB"}

package/dist/types/spec/repair.js

@@ -0,0 +1,3 @@
+// spec/repair.ts — Types for spec repair assistant (SPEC-164)
+export {};
+//# sourceMappingURL=repair.js.map

package/dist/types/spec/repair.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair.js","sourceRoot":"","sources":["../../../src/types/spec/repair.ts"],"names":[],"mappings":"AAAA,8DAA8D"}

package/dist/types/spec-decomposer.d.ts

@@ -0,0 +1,108 @@
+import type { ModelTier } from './multi-agent.js';
+/** Work unit enriched with resolved file assignments. */
+export interface MappedUnit {
+    id: string;
+    title: string;
+    criteria: string[];
+    /** Concrete file paths assigned to this unit (may overlap before resolution). */
+    files: string[];
+    recommendedModel: ModelTier;
+    estimatedHours: number;
+}
+/** A raw work unit before file ownership is assigned. */
+export interface WorkUnit {
+    /** Slug-based identifier (e.g. "unit-types", "unit-engine"). */
+    id: string;
+    /** Short human-readable title. */
+    title: string;
+    /** Acceptance criteria lines belonging to this unit. */
+    criteria: string[];
+    /** Files detected as likely relevant to these criteria. */
+    suggestedFiles: string[];
+    /** Model tier recommendation based on content analysis. */
+    recommendedModel: ModelTier;
+    /** Estimated hours (heuristic). */
+    estimatedHours: number;
+}
+/** A single agent task produced by spec decomposition. */
+export interface AgentTask {
+    /** Unique task identifier (e.g. "task-1-types"). */
+    id: string;
+    /** Short human-readable title. */
+    title: string;
+    /** Full description of what the agent should implement. */
+    description: string;
+    /** Acceptance criteria covered by this task. */
+    criteria: string[];
+    /** Files this agent exclusively owns (no other task may touch these). */
+    ownedFiles: string[];
+    /** IDs of tasks that must complete before this one starts. */
+    dependencies: string[];
+    /** Recommended model tier for this task. */
+    recommendedModel: ModelTier;
+    /** Estimated hours to complete this task. */
+    estimatedHours: number;
+    /** Whether this task can run in parallel with others. */
+    canRunParallel: boolean;
+}
+/** Ownership record linking a file path to a task ID. */
+export interface FileOwnership {
+    /** Absolute or repo-relative file path. */
+    filePath: string;
+    /** ID of the task that owns this file. */
+    taskId: string;
+}
+/** Conflict detected between two tasks that both claim the same file. */
+export interface OwnershipConflict {
+    /** File path claimed by multiple tasks. */
+    filePath: string;
+    /** IDs of the tasks competing for this file. */
+    conflictingTaskIds: string[];
+    /** Resolution applied: one task was given ownership, others receive dependency. */
+    resolution: string;
+}
+/** Result of resolving file ownership conflicts across mapped units. */
+export interface OwnershipResolutionResult {
+    tasks: AgentTask[];
+    fileOwnership: FileOwnership[];
+    conflicts: OwnershipConflict[];
+    executionPhases: DecomposeExecutionPhase[];
+}
+/** Result returned by the decomposeSpec() engine function. */
+export interface SpecDecomposeResult {
+    /** Spec identifier. */
+    specId: string;
+    /** Total number of tasks generated. */
+    taskCount: number;
+    /** Generated agent tasks. */
+    tasks: AgentTask[];
+    /** File ownership map (file → task). */
+    fileOwnership: FileOwnership[];
+    /** Conflicts detected and resolved during ownership assignment. */
+    conflicts: OwnershipConflict[];
+    /** Execution phases (tasks within a phase run in parallel). */
+    executionPhases: DecomposeExecutionPhase[];
+    /** Human-readable warnings (e.g. tasks with no files, oversized groups). */
+    warnings: string[];
+    /** Whether the result is ready to be fed into orchestrate_runtime. */
+    orchestrationReady: boolean;
+}
+/** A group of tasks that can run in parallel during the same phase. */
+export interface DecomposeExecutionPhase {
+    /** Phase number (1-based). */
+    phase: number;
+    /** Task IDs in this phase. */
+    taskIds: string[];
+    /** Reason for this grouping (e.g. "no shared files"). */
+    reason: string;
+}
+/** Input for the decompose_spec MCP tool. */
+export interface DecomposeSpecInput {
+    /** Project identifier (used to locate spec files). */
+    projectId: string;
+    /** Spec ID to decompose (e.g. "SPEC-042"). */
+    specId: string;
+    /** Maximum number of agent tasks to generate (default: 5). */
+    maxTasks?: number;
+}
+//# sourceMappingURL=spec-decomposer.d.ts.map

package/dist/types/spec-decomposer.d.ts.map

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

package/dist/types/spec-decomposer.js

@@ -0,0 +1,4 @@
+// Planu — Spec Decomposer types (SPEC-157)
+// Types for auto-decomposing a spec into parallelizable agent tasks with exclusive file ownership.
+export {};
+//# sourceMappingURL=spec-decomposer.js.map

package/dist/types/spec-decomposer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-decomposer.js","sourceRoot":"","sources":["../../src/types/spec-decomposer.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,mGAAmG"}

package/dist/types/spec-observability.d.ts

@@ -0,0 +1,71 @@
+export interface SpecUsageEvent {
+    /** The spec identifier referenced (e.g. "SPEC-042") */
+    readonly specId: string;
+    /** The MCP tool name that referenced the spec */
+    readonly toolName: string;
+    /** ISO 8601 timestamp of the access */
+    readonly timestamp: string;
+    /** Optional: acceptance criterion referenced (e.g. "AC-3") */
+    readonly acRef?: string;
+}
+export interface SpecUsageMetrics {
+    /** Spec identifier */
+    readonly specId: string;
+    /** Total number of accesses in the period */
+    readonly totalAccesses: number;
+    /** Distinct tools that referenced this spec */
+    readonly toolsUsed: readonly string[];
+    /** Map of toolName -> count */
+    readonly toolMatrix: Record<string, number>;
+    /** Most referenced acceptance criteria */
+    readonly hotAcs: readonly {
+        readonly acRef: string;
+        readonly count: number;
+    }[];
+    /** ISO 8601 timestamp of first access */
+    readonly firstAccessAt: string;
+    /** ISO 8601 timestamp of most recent access */
+    readonly lastAccessAt: string;
+}
+export interface SpecObservabilityReport {
+    /** Project ID */
+    readonly projectId: string;
+    /** Period used to filter events */
+    readonly period: 'day' | 'week' | 'month' | 'all';
+    /** ISO 8601 timestamp of report generation */
+    readonly generatedAt: string;
+    /** Total spec access events in period */
+    readonly totalEvents: number;
+    /** Hot specs: most frequently accessed */
+    readonly hotSpecs: readonly SpecUsageMetrics[];
+    /** Cold specs: approved but never accessed in the period (specIds only) */
+    readonly coldSpecs: readonly string[];
+    /** Metrics per spec (all specs that had at least one event) */
+    readonly specMetrics: readonly SpecUsageMetrics[];
+    /** Tool-level summary: which tools generated the most spec references */
+    readonly topTools: readonly {
+        readonly toolName: string;
+        readonly count: number;
+    }[];
+}
+export interface SpecUsageLog {
+    /** Append-only event list */
+    readonly events: readonly SpecUsageEvent[];
+}
+export interface SpecUsageReportInput {
+    readonly projectId: string;
+    readonly specId?: string;
+    readonly period?: 'day' | 'week' | 'month' | 'all';
+}
+/** Time period for filtering usage events. */
+export type Period = 'day' | 'week' | 'month' | 'all';
+/** Options for building an observability report. */
+export interface BuildReportOptions {
+    projectId: string;
+    period: Period;
+    events: readonly SpecUsageEvent[];
+    allKnownSpecIds?: readonly string[];
+    /** Filter to a single spec when specId is provided */
+    filterSpecId?: string;
+}
+//# sourceMappingURL=spec-observability.d.ts.map

package/dist/types/spec-observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-observability.d.ts","sourceRoot":"","sources":["../../src/types/spec-observability.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,uCAAuC;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD,MAAM,WAAW,gBAAgB;IAC/B,sBAAsB;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6CAA6C;IAC7C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,+BAA+B;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,SAAS;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/E,yCAAyC;IACzC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,+CAA+C;IAC/C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAMD,MAAM,WAAW,uBAAuB;IACtC,iBAAiB;IACjB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,mCAAmC;IACnC,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;IAClD,8CAA8C;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,yCAAyC;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,0CAA0C;IAC1C,QAAQ,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC/C,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAClD,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,EAAE,SAAS;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACrF;AAMD,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC;CAC5C;AAMD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;CACpD;AAMD,8CAA8C;AAC9C,MAAM,MAAM,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAEtD,oDAAoD;AACpD,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC;IAClC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/types/spec-observability.js

@@ -0,0 +1,4 @@
+// types/spec-observability.ts — Spec observability types (SPEC-158)
+// Tracks which specs are actively used by agents: access patterns, hot/cold specs, tool matrix.
+export {};
+//# sourceMappingURL=spec-observability.js.map

package/dist/types/spec-observability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-observability.js","sourceRoot":"","sources":["../../src/types/spec-observability.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,gGAAgG"}

package/dist/types/spec-versioning.d.ts

@@ -0,0 +1,117 @@
+/** A tagged version snapshot of a spec (git-like versioning). */
+export interface SpecVersionSnapshot {
+    /** Semantic version tag, e.g. "v1.0.0", "v1.1.0" */
+    tag: string;
+    /** ISO 8601 timestamp when the snapshot was created */
+    timestamp: string;
+    /** Full spec content at time of snapshot */
+    content: string;
+    /** Optional human-readable message describing this version */
+    message?: string;
+    /** Optional author identifier */
+    author?: string;
+}
+/** Storage structure for all snapshots of a spec. */
+export interface SpecVersionSnapshotStore {
+    specId: string;
+    versions: SpecVersionSnapshot[];
+}
+/** A spec branch for experimental changes. */
+export interface SpecBranch {
+    /** Branch name (kebab-case) */
+    name: string;
+    /** The spec ID this branch belongs to */
+    specId: string;
+    /** ISO 8601 timestamp when the branch was created */
+    createdAt: string;
+    /** Version tag from which this branch was created */
+    fromVersion: string;
+    /** Full spec content on this branch */
+    content: string;
+}
+/** Diff result between two spec versions at AC-level granularity. */
+export interface SpecVersionDiff {
+    fromTag: string;
+    toTag: string;
+    specId: string;
+    /** Lines added in the "to" version */
+    added: string[];
+    /** Lines removed compared to "from" version */
+    removed: string[];
+    /** Acceptance criteria that changed (AC-level granularity) */
+    criteriaChanges: {
+        added: string[];
+        removed: string[];
+        modified: {
+            before: string;
+            after: string;
+        }[];
+    };
+    /** Summary of sections that changed */
+    sectionChanges: string[];
+}
+/** Conflict detected when merging a branch back into main. */
+export interface SpecMergeConflict {
+    type: 'content_diverged' | 'concurrent_edit';
+    description: string;
+    /** The conflicting lines or sections */
+    details: string[];
+}
+/** Result of a merge operation. */
+export interface SpecMergeResult {
+    success: boolean;
+    specId: string;
+    branchName: string;
+    newVersionTag?: string;
+    conflicts: SpecMergeConflict[];
+    message: string;
+}
+/** Input options for creating a spec version snapshot. */
+export interface CreateVersionSnapshotInput {
+    projectId: string;
+    specId: string;
+    tag: string;
+    content: string;
+    message?: string;
+    author?: string;
+}
+/** Input options for creating a spec branch. */
+export interface CreateSpecBranchInput {
+    projectId: string;
+    specId: string;
+    branchName: string;
+    fromVersion?: string;
+    content: string;
+}
+/** Input options for merging a spec branch. */
+export interface MergeSpecBranchInput {
+    projectId: string;
+    specId: string;
+    branchName: string;
+    /** Optional merged spec content (if pre-resolved). If absent, auto-merge is attempted. */
+    resolvedContent?: string;
+    newVersionTag?: string;
+    message?: string;
+}
+/** Input for the branch_spec tool. */
+export interface BranchSpecInput {
+    projectId: string;
+    specId: string;
+    branchName: string;
+    fromVersion?: string;
+    /** Path to the spec file to read content from */
+    specPath?: string;
+}
+/** Input for the version_spec tool. */
+export interface VersionSpecInput {
+    projectId: string;
+    specId: string;
+    tag?: string;
+    message?: string;
+    author?: string;
+    /** Absolute path to the spec's spec.md file. */
+    specPath?: string;
+}
+/** Input for the merge_spec_branch tool handler — alias for MergeSpecBranchInput. */
+export type MergeSpecBranchHandlerInput = MergeSpecBranchInput;
+//# sourceMappingURL=spec-versioning.d.ts.map

package/dist/types/spec-versioning.d.ts.map

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

package/dist/types/spec-versioning.js

@@ -0,0 +1,3 @@
+// types/spec-versioning.ts — Types for spec versioning and branching (SPEC-168)
+export {};
+//# sourceMappingURL=spec-versioning.js.map

package/dist/types/spec-versioning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-versioning.js","sourceRoot":"","sources":["../../src/types/spec-versioning.ts"],"names":[],"mappings":"AAAA,gFAAgF"}

package/dist/types/well-known.d.ts

@@ -0,0 +1,70 @@
+import type { Spec } from './spec/core.js';
+/** Summary of a single spec included in the .well-known manifest. */
+export interface ManifestSpec {
+    /** Spec ID (e.g. "SPEC-001"). */
+    id: string;
+    /** Human-readable title. */
+    title: string;
+    /** Spec status. */
+    status: string;
+    /** Spec type (feature, bug, chore, etc.). */
+    type: string;
+    /** Short description (up to 200 characters). */
+    description: string;
+    /** Tags associated with the spec. */
+    tags: string[];
+    /** ISO 8601 creation date. */
+    created: string;
+}
+/** .well-known/planu.json manifest format v1. */
+export interface WellKnownManifest {
+    /** Manifest schema version. Always 1 for this format. */
+    version: 1;
+    /** Project display name. */
+    name: string;
+    /** Total number of specs included. */
+    specCount: number;
+    /** Spec summaries (public specs only, unless includePrivate=true). */
+    specs: ManifestSpec[];
+    /** Planu capabilities exported by this project. */
+    capabilities: string[];
+    /** ISO 8601 timestamp when this manifest was generated. */
+    generatedAt: string;
+}
+/** Input for the publish_registry tool handler. */
+export interface PublishRegistryInput {
+    /** Project ID (hash). */
+    projectId: string;
+    /** Absolute path where .well-known/planu.json will be written. */
+    outputPath?: string;
+    /** Whether to include specs with status "private". Default: false. */
+    includePrivate?: boolean;
+}
+/** Input for the discover_registry tool handler. */
+export interface DiscoverRegistryInput {
+    /** Absolute path to a .well-known/planu.json manifest file. */
+    manifestPath: string;
+}
+/** Options for generating a manifest. */
+export interface ManifestGeneratorOptions {
+    /** Project display name. */
+    projectName: string;
+    /** List of all specs for the project. */
+    specs: Spec[];
+    /** Whether to include specs with a private or draft status. */
+    includePrivate: boolean;
+}
+/** A capability identifier that a project can declare in its manifest. */
+export type KnownCapability = 'spec-registry' | 'federation' | 'living-spec' | 'ai-analysis' | 'estimation' | 'changelog';
+/** Result of parsing and validating a manifest. */
+export interface DiscoveryResult {
+    /** Whether the manifest was successfully parsed and validated. */
+    valid: boolean;
+    /** Parsed manifest (present when valid is true). */
+    manifest?: WellKnownManifest;
+    /** Validation errors (present when valid is false). */
+    errors?: string[];
+    /** Source path of the manifest. */
+    source: string;
+}
+//# sourceMappingURL=well-known.d.ts.map

package/dist/types/well-known.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"well-known.d.ts","sourceRoot":"","sources":["../../src/types/well-known.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE3C,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,iDAAiD;AACjD,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,OAAO,EAAE,CAAC,CAAC;IACX,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,mDAAmD;IACnD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,mDAAmD;AACnD,MAAM,WAAW,oBAAoB;IACnC,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,oDAAoD;AACpD,MAAM,WAAW,qBAAqB;IACpC,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,yCAAyC;AACzC,MAAM,WAAW,wBAAwB;IACvC,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,+DAA+D;IAC/D,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,0EAA0E;AAC1E,MAAM,MAAM,eAAe,GACvB,eAAe,GACf,YAAY,GACZ,aAAa,GACb,aAAa,GACb,YAAY,GACZ,WAAW,CAAC;AAEhB,mDAAmD;AACnD,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,KAAK,EAAE,OAAO,CAAC;IACf,oDAAoD;IACpD,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/types/well-known.js

@@ -0,0 +1,3 @@
+// types/well-known.ts — SPEC-162: .well-known spec-registry discovery domain types
+export {};
+//# sourceMappingURL=well-known.js.map

package/dist/types/well-known.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"well-known.js","sourceRoot":"","sources":["../../src/types/well-known.ts"],"names":[],"mappings":"AAAA,mFAAmF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@planu/cli",
-  "version": "0.63.7",
+  "version": "0.64.1",
   "description": "Planu — MCP Server for Spec Driven Development. Manages specs, estimations, reverse engineering, and auto-learning across any language/framework.",
   "type": "module",
   "main": "dist/index.js",

package/src/config/license-plans.json

@@ -122,10 +122,13 @@
     "export_session",
     "security_report",
     "configure_workers",
+    "configure_roles",
+    "assign_role",
     "orchestrate_runtime",
     "agent_swarm_status",
     "configure_llm_providers",
     "llm_provider_status",
+    "configure_observability",
     "manage_plugins",
     "scaffold_plugin",
     "create_pr_from_spec",
@@ -155,7 +158,19 @@
     "registry_logout",
     "registry_whoami",
     "scan_project",
-    "ecosystem_status"
+    "ecosystem_status",
+    "audit_trail",
+    "generate_attestation",
+    "branch_spec",
+    "merge_spec_branch",
+    "version_spec",
+    "decompose_spec",
+    "federate_specs",
+    "federation_status",
+    "discover_registry",
+    "publish_registry",
+    "generate_infrastructure",
+    "spec_usage_report"
   ],
   "alwaysAllowed": [
     "activate_license",