mano-coding 0.1.15

package/dist/index.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Extension SDK 公共契约 (DD-03)
+ */
+export type JsonValue = null | boolean | number | string | readonly JsonValue[] | {
+    readonly [key: string]: JsonValue;
+};
+export type InputValue = string | boolean | number;
+export type ExtensionOperation = 'create' | 'apply' | 'install' | 'configure' | 'remove';
+export type CapabilityType = 'skill' | 'rule' | 'instruction' | 'mcp' | 'agent';
+export type TargetId = 'cursor' | 'opencode' | 'claude-code' | 'codex' | 'codebuddy' | 'trae' | 'deepseek-harness';
+export interface TargetRef {
+    id: TargetId;
+    scope: 'project';
+    hostVersion?: string;
+}
+export interface ProjectFileSystem {
+    readonly root: string;
+    readonly exists: boolean;
+    read(path: string): Promise<Uint8Array | undefined>;
+    write(path: string, content: Uint8Array | string): Promise<void>;
+    remove(path: string): Promise<void>;
+    mkdir(path: string): Promise<void>;
+}
+export interface CommandRegistration {
+    readonly name: string;
+    readonly executable: string;
+    readonly args?: readonly string[];
+}
+export type EnvironmentChange = {
+    readonly type: 'path';
+    readonly path: string;
+    readonly operation: 'prepend' | 'append';
+} | {
+    readonly type: 'variable';
+    readonly name: string;
+    readonly value: string;
+};
+export interface UserInstallationFileSystem {
+    readonly root: string;
+    write(path: string, content: Uint8Array | string): Promise<void>;
+    remove(path: string): Promise<void>;
+    mkdir(path: string): Promise<void>;
+    registerCommand(command: CommandRegistration): Promise<void>;
+    registerEnvironment(change: EnvironmentChange): Promise<void>;
+}
+export interface ExecRequest {
+    readonly command: string;
+    readonly args?: readonly string[];
+    readonly cwd?: 'project' | 'installation';
+    readonly env?: Readonly<Record<string, string>>;
+    readonly timeoutMs?: number;
+}
+export interface ExecResult {
+    readonly exitCode: number;
+    readonly stdout: string;
+    readonly stderr: string;
+}
+export interface ProcessExecutor {
+    run(request: ExecRequest): Promise<ExecResult>;
+}
+export interface HttpClient {
+    fetch(url: string, init?: RequestInit): Promise<Response>;
+}
+export interface SecretReader {
+    get(name: string): Promise<string | undefined>;
+}
+export interface ExtensionLogger {
+    debug(message: string, fields?: Readonly<Record<string, JsonValue>>): void;
+    info(message: string, fields?: Readonly<Record<string, JsonValue>>): void;
+    warn(message: string, fields?: Readonly<Record<string, JsonValue>>): void;
+}
+export interface TargetDeliveryRequest {
+    readonly target: TargetRef;
+    readonly capabilityType: CapabilityType;
+    readonly id: string;
+    readonly source: string;
+}
+export interface TargetWriter {
+    deliver(request: TargetDeliveryRequest): Promise<void>;
+}
+export interface RollbackRegistrar {
+    defer(name: string, action: () => Promise<void>): void;
+}
+export interface ExtensionContext {
+    readonly mode: 'plan' | 'execute';
+    readonly operation: ExtensionOperation;
+    readonly package: {
+        readonly id: string;
+        readonly version: string;
+        readonly root: string;
+    };
+    readonly inputs: Readonly<Record<string, InputValue>>;
+    readonly project: ProjectFileSystem;
+    readonly user: UserInstallationFileSystem;
+    readonly exec: ProcessExecutor;
+    readonly http: HttpClient;
+    readonly secrets: SecretReader;
+    readonly log: ExtensionLogger;
+    readonly rollback: RollbackRegistrar;
+    readonly signal: AbortSignal;
+}
+export interface ProjectExtensionContext extends ExtensionContext {
+}
+export interface CapabilityDescriptor {
+    readonly packageId: string;
+    readonly id: string;
+    readonly type: CapabilityType;
+    readonly version: string;
+    readonly targets: readonly TargetRef[];
+}
+export interface CapabilityInstallContext extends ExtensionContext {
+    readonly capability: CapabilityDescriptor;
+}
+export interface CapabilityConfigureContext extends ExtensionContext {
+    readonly capability: CapabilityDescriptor;
+    readonly targets: TargetWriter;
+}
+export interface CapabilityRemoveContext extends ExtensionContext {
+    readonly capability: CapabilityDescriptor;
+    readonly resources: readonly ManagedResource[];
+}
+export interface CapabilityHealthContext extends ExtensionContext {
+    readonly capability: CapabilityDescriptor;
+}
+export interface ProjectResult {
+    readonly summary?: string;
+    readonly outputs?: Readonly<Record<string, JsonValue>>;
+}
+export type InstallResult = {
+    readonly kind: 'none';
+} | {
+    readonly kind: 'user';
+};
+export interface ConfigureResult {
+    readonly summary?: string;
+}
+export interface ManagedResource {
+    readonly type: 'file' | 'config-entry';
+    readonly path: string;
+    readonly selector?: string;
+    readonly digest: string;
+}
+export interface RetainedSideEffect {
+    readonly description: string;
+    readonly reason: string;
+}
+export interface RemoveResult {
+    readonly summary?: string;
+    readonly retained?: readonly RetainedSideEffect[];
+}
+export interface HealthReport {
+    readonly status: 'healthy' | 'degraded' | 'broken';
+    readonly message?: string;
+}
+export declare abstract class ProjectExtension {
+    static readonly id: string;
+    abstract create(context: ProjectExtensionContext): Promise<ProjectResult>;
+    abstract apply(context: ProjectExtensionContext): Promise<ProjectResult>;
+}
+export declare abstract class CapabilityExtension {
+    static readonly id: string;
+    static readonly type: CapabilityType;
+    abstract install(context: CapabilityInstallContext): Promise<InstallResult>;
+    abstract configure(context: CapabilityConfigureContext, installation: InstallResult): Promise<ConfigureResult>;
+    abstract remove(context: CapabilityRemoveContext): Promise<RemoveResult>;
+    healthCheck?(context: CapabilityHealthContext): Promise<HealthReport>;
+}
+export declare class ExtensionError extends Error {
+    readonly code: string;
+    readonly safeMessage: string;
+    readonly details?: Readonly<Record<string, JsonValue>>;
+    readonly retryable?: boolean;
+    constructor(code: string, safeMessage: string, details?: Readonly<Record<string, JsonValue>>, retryable?: boolean);
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,31 @@
+import { createRequire as __createRequire } from 'node:module';
+const require = __createRequire(import.meta.url);
+
+
+// packages/sdk/src/index.ts
+var ProjectExtension = class {
+  static id;
+};
+var CapabilityExtension = class {
+  static id;
+  static type;
+};
+var ExtensionError = class extends Error {
+  code;
+  safeMessage;
+  details;
+  retryable;
+  constructor(code, safeMessage, details, retryable) {
+    super(safeMessage);
+    this.name = "ExtensionError";
+    this.code = code;
+    this.safeMessage = safeMessage;
+    this.details = details;
+    this.retryable = retryable;
+  }
+};
+export {
+  CapabilityExtension,
+  ExtensionError,
+  ProjectExtension
+};

package/dist/schemas/installations.schema.json

@@ -0,0 +1,206 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "installations.schema.json",
+  "title": "Mano Coding User Installations",
+  "type": "object",
+  "required": ["kind", "generatedBy", "machine", "updatedAt", "installations"],
+  "properties": {
+    "kind": { "const": "Installations" },
+    "generatedBy": { "$ref": "#/$defs/generatedBy" },
+    "machine": { "$ref": "#/$defs/machine" },
+    "updatedAt": { "$ref": "#/$defs/dateTime" },
+    "installations": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/installation" }
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "packageName": {
+      "type": "string",
+      "pattern": "^(?:@[a-z0-9][a-z0-9._-]*/)?[a-z0-9][a-z0-9._-]*$",
+      "maxLength": 214
+    },
+    "localId": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$",
+      "maxLength": 64
+    },
+    "semver": {
+      "type": "string",
+      "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*)?(?:\\+[0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*)?$"
+    },
+    "integrity": {
+      "type": "string",
+      "pattern": "^(sha256|sha512)-[A-Za-z0-9+/]+={0,2}$",
+      "maxLength": 256
+    },
+    "digest": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "dateTime": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "absolutePath": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 1024,
+      "pattern": "^(?!.*\\\\).+$",
+      "description": "Machine-local normalized absolute path; forward slashes only, even on Windows"
+    },
+    "generatedBy": {
+      "type": "object",
+      "required": ["cliVersion"],
+      "properties": {
+        "cliVersion": { "$ref": "#/$defs/semver" }
+      },
+      "additionalProperties": false
+    },
+    "machine": {
+      "type": "object",
+      "required": ["platform", "arch"],
+      "properties": {
+        "platform": { "enum": ["win32", "darwin", "linux"] },
+        "arch": { "enum": ["x64", "arm64"] }
+      },
+      "additionalProperties": false
+    },
+    "owner": {
+      "type": "object",
+      "required": ["kind", "packageId", "id"],
+      "properties": {
+        "kind": { "enum": ["project", "capability", "plugin"] },
+        "packageId": { "$ref": "#/$defs/packageName" },
+        "id": { "$ref": "#/$defs/localId" }
+      },
+      "additionalProperties": false
+    },
+    "command": {
+      "type": "object",
+      "required": ["name", "executable", "args"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "executable": { "$ref": "#/$defs/absolutePath" },
+        "args": {
+          "type": "array",
+          "items": { "type": "string", "maxLength": 1024 }
+        }
+      },
+      "additionalProperties": false
+    },
+    "pathEntry": {
+      "type": "object",
+      "required": ["path", "operation"],
+      "properties": {
+        "path": { "$ref": "#/$defs/absolutePath" },
+        "operation": { "enum": ["prepend", "append"] }
+      },
+      "additionalProperties": false
+    },
+    "environmentVariable": {
+      "type": "object",
+      "required": ["name", "valueDigest"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
+          "maxLength": 128
+        },
+        "valueDigest": { "$ref": "#/$defs/digest" }
+      },
+      "additionalProperties": false
+    },
+    "environment": {
+      "type": "object",
+      "required": ["pathEntries", "variables"],
+      "properties": {
+        "pathEntries": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/pathEntry" }
+        },
+        "variables": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/environmentVariable" }
+        }
+      },
+      "additionalProperties": false
+    },
+    "reference": {
+      "type": "object",
+      "required": ["projectRoot", "lockDigest", "lastSeenAt"],
+      "properties": {
+        "projectRoot": { "$ref": "#/$defs/absolutePath" },
+        "lockDigest": { "$ref": "#/$defs/digest" },
+        "lastSeenAt": { "$ref": "#/$defs/dateTime" }
+      },
+      "additionalProperties": false
+    },
+    "health": {
+      "type": "object",
+      "required": ["status"],
+      "properties": {
+        "status": { "enum": ["unknown", "healthy", "degraded", "broken"] },
+        "checkedAt": { "$ref": "#/$defs/dateTime" },
+        "message": { "type": "string", "minLength": 1, "maxLength": 500 }
+      },
+      "additionalProperties": false
+    },
+    "failure": {
+      "type": "object",
+      "required": ["code", "message", "failedAt"],
+      "properties": {
+        "code": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "message": { "type": "string", "minLength": 1, "maxLength": 500 },
+        "failedAt": { "$ref": "#/$defs/dateTime" }
+      },
+      "additionalProperties": false
+    },
+    "installation": {
+      "type": "object",
+      "required": [
+        "owner",
+        "version",
+        "state",
+        "integrity",
+        "commands",
+        "environment",
+        "references",
+        "health",
+        "updatedAt"
+      ],
+      "properties": {
+        "owner": { "$ref": "#/$defs/owner" },
+        "version": { "$ref": "#/$defs/semver" },
+        "state": { "enum": ["ready", "failed"] },
+        "root": { "$ref": "#/$defs/absolutePath" },
+        "integrity": { "$ref": "#/$defs/integrity" },
+        "commands": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/command" }
+        },
+        "environment": { "$ref": "#/$defs/environment" },
+        "references": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/reference" }
+        },
+        "health": { "$ref": "#/$defs/health" },
+        "installedAt": { "$ref": "#/$defs/dateTime" },
+        "updatedAt": { "$ref": "#/$defs/dateTime" },
+        "failure": { "$ref": "#/$defs/failure" }
+      },
+      "additionalProperties": false,
+      "allOf": [
+        {
+          "if": {
+            "properties": { "state": { "const": "ready" } },
+            "required": ["state"]
+          },
+          "then": { "required": ["root", "installedAt"] },
+          "else": { "required": ["failure"] }
+        }
+      ]
+    }
+  }
+}

package/dist/schemas/manifest.schema.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "manifest.schema.json",
+  "title": "Mano Coding Template Manifest",
+  "type": "object",
+  "required": ["id", "version", "name", "description"],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^(?:@[a-z0-9][a-z0-9._-]*/)?[a-z0-9][a-z0-9._-]*$",
+      "maxLength": 214
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*)?(?:\\+[0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*)?$"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 100
+    },
+    "description": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 1000
+    },
+    "tasks": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "command"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[a-zA-Z][a-zA-Z0-9_-]*$",
+            "maxLength": 64
+          },
+          "command": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 256
+          },
+          "args": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "cwd": {
+            "type": "string",
+            "maxLength": 512
+          },
+          "env": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "string"
+            }
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}