perttool 0.5.0 → 0.5.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "perttool",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Document-based PERT/CPM and resource scheduling CLI",
   "keywords": [
     "pert",
@@ -26,6 +26,7 @@
   "type": "module",
   "files": [
     "dist",
+    "schemas",
     "CHANGELOG.md"
   ],
   "bin": {
@@ -37,7 +38,8 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
-    }
+    },
+    "./schemas/*": "./schemas/*"
   },
   "engines": {
     "node": ">=22"
@@ -57,6 +59,7 @@
   },
   "devDependencies": {
     "@types/node": "22.20.1",
+    "ajv": "^8.20.0",
     "typescript": "7.0.2"
   }
 }

package/schemas/Perttool.AgentGuidanceResult.v1.schema.json

@@ -0,0 +1,152 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mako10k/perttool/schemas/Perttool.AgentGuidanceResult.v1.schema.json",
+  "title": "Perttool.AgentGuidanceResult.v1",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "cli_contract_version",
+    "guidance_interface_version",
+    "profile_schema_version",
+    "profile_data_version",
+    "guidance_taxonomy_version",
+    "risk_taxonomy_version",
+    "description_registry_version",
+    "description_locale",
+    "staleness_policy_version",
+    "tool_version",
+    "operation",
+    "ok",
+    "profile_digest",
+    "snapshot_as_of",
+    "query",
+    "providers",
+    "guidance_records",
+    "risk_records",
+    "sources",
+    "capabilities",
+    "diagnostics"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "Perttool.AgentGuidanceResult.v1"
+    },
+    "cli_contract_version": {
+      "const": 6
+    },
+    "guidance_interface_version": {
+      "const": 1
+    },
+    "profile_schema_version": {
+      "type": "string"
+    },
+    "profile_data_version": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "guidance_taxonomy_version": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "risk_taxonomy_version": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "description_registry_version": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "description_locale": {
+      "const": "en"
+    },
+    "staleness_policy_version": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "tool_version": {
+      "type": "string"
+    },
+    "operation": {
+      "const": "agent.help"
+    },
+    "ok": {
+      "type": "boolean"
+    },
+    "profile_digest": {
+      "$ref": "Perttool.Common.v1.schema.json#/$defs/digest"
+    },
+    "snapshot_as_of": {
+      "type": "string"
+    },
+    "query": {
+      "type": "object"
+    },
+    "providers": {
+      "type": "array",
+      "items": {
+        "type": "object"
+      }
+    },
+    "guidance_records": {
+      "type": "array",
+      "items": {
+        "type": "object"
+      }
+    },
+    "risk_records": {
+      "type": "array",
+      "items": {
+        "type": "object"
+      }
+    },
+    "sources": {
+      "type": "array",
+      "items": {
+        "type": "object"
+      }
+    },
+    "capabilities": {
+      "type": "object",
+      "required": [
+        "reads_project_files",
+        "writes_files",
+        "executes_hooks",
+        "executes_commands",
+        "accesses_network",
+        "reads_provider_state",
+        "writes_provider_state"
+      ],
+      "properties": {
+        "reads_project_files": {
+          "type": "boolean"
+        },
+        "writes_files": {
+          "type": "boolean"
+        },
+        "executes_hooks": {
+          "type": "boolean"
+        },
+        "executes_commands": {
+          "type": "boolean"
+        },
+        "accesses_network": {
+          "type": "boolean"
+        },
+        "reads_provider_state": {
+          "type": "boolean"
+        },
+        "writes_provider_state": {
+          "type": "boolean"
+        }
+      },
+      "additionalProperties": false
+    },
+    "diagnostics": {
+      "type": "array",
+      "items": {
+        "type": "object"
+      }
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/Perttool.AnalysisResult.v4.schema.json

@@ -0,0 +1,124 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mako10k/perttool/schemas/Perttool.AnalysisResult.v4.schema.json",
+  "title": "Perttool.AnalysisResult.v4",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "cli_contract_version",
+    "tool_version",
+    "operation",
+    "ok",
+    "document_id",
+    "source",
+    "source_digest",
+    "diagnostics",
+    "diagnostics_truncated",
+    "grammar_version",
+    "task_actuals",
+    "mode",
+    "precision",
+    "precedence",
+    "resource",
+    "temporal"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "Perttool.AnalysisResult.v4"
+    },
+    "cli_contract_version": {
+      "const": 6
+    },
+    "tool_version": {
+      "type": "string"
+    },
+    "operation": {
+      "const": "dag.analyze"
+    },
+    "ok": {
+      "type": "boolean"
+    },
+    "document_id": {
+      "$ref": "Perttool.Common.v1.schema.json#/$defs/nullableString"
+    },
+    "source": {
+      "type": "string"
+    },
+    "source_digest": {
+      "$ref": "Perttool.Common.v1.schema.json#/$defs/digest"
+    },
+    "diagnostics": {
+      "$ref": "Perttool.Common.v1.schema.json#/$defs/diagnostics"
+    },
+    "diagnostics_truncated": {
+      "type": "boolean"
+    },
+    "grammar_version": {
+      "type": [
+        "integer",
+        "null"
+      ],
+      "minimum": 1,
+      "maximum": 5
+    },
+    "task_actuals": {
+      "type": "array",
+      "items": {
+        "type": "object"
+      }
+    },
+    "mode": {
+      "enum": [
+        "precedence",
+        "resource",
+        "both"
+      ]
+    },
+    "precision": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 9
+    },
+    "duration_unit": {
+      "enum": [
+        "day",
+        "hour",
+        "point"
+      ]
+    },
+    "critical_epsilon": {
+      "type": "object"
+    },
+    "velocity": {
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "velocity_forecast": {
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "precedence": {
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "resource": {
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "temporal": {
+      "type": [
+        "object",
+        "null"
+      ]
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/Perttool.CheckResult.v3.schema.json

@@ -0,0 +1,159 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mako10k/perttool/schemas/Perttool.CheckResult.v3.schema.json",
+  "title": "Perttool.CheckResult.v3",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "cli_contract_version",
+    "tool_version",
+    "operation",
+    "ok",
+    "document_id",
+    "source",
+    "source_digest",
+    "diagnostics",
+    "diagnostics_truncated",
+    "grammar_version",
+    "summary",
+    "temporal_inputs",
+    "actuals_inputs"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "Perttool.CheckResult.v3"
+    },
+    "cli_contract_version": {
+      "const": 6
+    },
+    "tool_version": {
+      "type": "string"
+    },
+    "operation": {
+      "const": "document.check"
+    },
+    "ok": {
+      "type": "boolean"
+    },
+    "document_id": {
+      "$ref": "Perttool.Common.v1.schema.json#/$defs/nullableString"
+    },
+    "source": {
+      "type": "string"
+    },
+    "source_digest": {
+      "$ref": "Perttool.Common.v1.schema.json#/$defs/digest"
+    },
+    "diagnostics": {
+      "$ref": "Perttool.Common.v1.schema.json#/$defs/diagnostics"
+    },
+    "diagnostics_truncated": {
+      "type": "boolean"
+    },
+    "grammar_version": {
+      "type": [
+        "integer",
+        "null"
+      ],
+      "minimum": 1,
+      "maximum": 5
+    },
+    "summary": {
+      "type": "object",
+      "required": [
+        "resources",
+        "milestones",
+        "tasks",
+        "gates",
+        "errors",
+        "warnings"
+      ],
+      "properties": {
+        "resources": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "milestones": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "tasks": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "gates": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "errors": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "warnings": {
+          "type": "integer",
+          "minimum": 0
+        }
+      },
+      "additionalProperties": false
+    },
+    "temporal_inputs": {
+      "type": [
+        "object",
+        "null"
+      ],
+      "required": [
+        "anchor",
+        "milestone_deadlines",
+        "task_constraints"
+      ],
+      "properties": {
+        "anchor": {
+          "oneOf": [
+            {
+              "$ref": "Perttool.Common.v1.schema.json#/$defs/calendarValue"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "milestone_deadlines": {
+          "type": "array",
+          "items": {
+            "type": "object"
+          }
+        },
+        "task_constraints": {
+          "type": "array",
+          "items": {
+            "type": "object"
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "actuals_inputs": {
+      "type": [
+        "object",
+        "null"
+      ],
+      "required": [
+        "model_version",
+        "events"
+      ],
+      "properties": {
+        "model_version": {
+          "const": 1
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "$ref": "Perttool.Common.v1.schema.json#/$defs/workEvent"
+          }
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/Perttool.CliError.v1.schema.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mako10k/perttool/schemas/Perttool.CliError.v1.schema.json",
+  "title": "Perttool.CliError.v1",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "cli_contract_version",
+    "tool_version",
+    "operation",
+    "ok",
+    "diagnostics"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "Perttool.CliError.v1"
+    },
+    "cli_contract_version": {
+      "const": 6
+    },
+    "tool_version": {
+      "type": "string"
+    },
+    "operation": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "ok": {
+      "const": false
+    },
+    "help_target": {
+      "type": "object",
+      "required": [
+        "resource",
+        "action"
+      ],
+      "properties": {
+        "resource": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "action": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "additionalProperties": false
+    },
+    "usage": {
+      "type": "object",
+      "required": [
+        "kind",
+        "token",
+        "suggestion"
+      ],
+      "properties": {
+        "kind": {
+          "type": "string"
+        },
+        "token": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/nullableString"
+        },
+        "suggestion": {
+          "type": [
+            "object",
+            "null"
+          ]
+        }
+      },
+      "additionalProperties": false
+    },
+    "diagnostics": {
+      "$ref": "Perttool.Common.v1.schema.json#/$defs/diagnostics"
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/Perttool.CommandHelpResult.v1.schema.json

@@ -0,0 +1,165 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mako10k/perttool/schemas/Perttool.CommandHelpResult.v1.schema.json",
+  "title": "Perttool.CommandHelpResult.v1",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "cli_contract_version",
+    "tool_version",
+    "operation",
+    "ok",
+    "query",
+    "resources",
+    "commands",
+    "diagnostics"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "Perttool.CommandHelpResult.v1"
+    },
+    "cli_contract_version": {
+      "const": 6
+    },
+    "tool_version": {
+      "type": "string"
+    },
+    "operation": {
+      "const": "help"
+    },
+    "ok": {
+      "type": "boolean"
+    },
+    "query": {
+      "type": "object",
+      "required": [
+        "resource",
+        "action"
+      ],
+      "properties": {
+        "resource": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/nullableString"
+        },
+        "action": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/nullableString"
+        }
+      },
+      "additionalProperties": false
+    },
+    "resources": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "name",
+          "summary",
+          "actions"
+        ],
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "summary": {
+            "type": "string"
+          },
+          "actions": {
+            "$ref": "Perttool.Common.v1.schema.json#/$defs/stringArray"
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "commands": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "cli_contract_version",
+          "path",
+          "operation",
+          "summary",
+          "operands",
+          "options",
+          "input",
+          "output",
+          "stdin",
+          "effect",
+          "result_schemas",
+          "exit_statuses",
+          "examples"
+        ],
+        "properties": {
+          "cli_contract_version": {
+            "const": 6
+          },
+          "path": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "minItems": 1,
+            "maxItems": 2
+          },
+          "operation": {
+            "type": "string"
+          },
+          "summary": {
+            "type": "string"
+          },
+          "operands": {
+            "type": "array",
+            "items": {
+              "type": "object"
+            }
+          },
+          "options": {
+            "type": "array",
+            "items": {
+              "type": "object"
+            }
+          },
+          "input": {
+            "enum": [
+              "none",
+              "document",
+              "artifact"
+            ]
+          },
+          "output": {
+            "type": "object"
+          },
+          "stdin": {
+            "type": "object"
+          },
+          "effect": {
+            "enum": [
+              "read",
+              "preview",
+              "write-or-create"
+            ]
+          },
+          "result_schemas": {
+            "$ref": "Perttool.Common.v1.schema.json#/$defs/stringArray"
+          },
+          "exit_statuses": {
+            "type": "array",
+            "items": {
+              "type": "object"
+            }
+          },
+          "examples": {
+            "type": "array",
+            "items": {
+              "type": "object"
+            }
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "diagnostics": {
+      "$ref": "Perttool.Common.v1.schema.json#/$defs/diagnostics"
+    }
+  },
+  "additionalProperties": false
+}