@papillon6814/pi-gh 0.0.0-stage → 0.2.0

package/dist/src/result.js

@@ -0,0 +1,5 @@
+import { DataError } from './core/data.js';
+import { maskDecodedSecrets } from './core/secrets.js';
+export function safeResult(result) { return maskDecodedSecrets(result).value; }
+export function rejected(code, message) { return safeResult({ status: 'rejected', problems: [{ code, path: '', message }] }); }
+export function errorResult(error) { return error instanceof DataError ? safeResult({ status: 'rejected', problems: [{ code: error.code, path: error.field, message: error.message }] }) : rejected('OPERATION_FAILED', 'Operation could not be confirmed.'); }

package/dist/src/service-types.d.ts

@@ -0,0 +1,37 @@
+import type { ValidationProblem } from './core/types.js';
+import type { PermissionLease } from './permissions.js';
+export type Operation = 'gh_issue_validate' | 'gh_issue_preview' | 'gh_issue_submit' | 'gh_labels_validate' | 'gh_labels_preview' | 'gh_labels_apply' | 'gh_issue_form';
+export type IssueArgs = {
+    draftPath: string;
+    template?: 'parent' | 'task';
+    templatePath?: string;
+};
+export type LabelsArgs = {
+    changePath: string;
+};
+export type FormArgs = {
+    template?: 'parent' | 'task';
+    templatePath?: string;
+};
+export type ApprovalView = {
+    operation: string;
+    text: string;
+    digest: string;
+};
+export type OperationContext = {
+    cwd: string;
+    packageRoot: string;
+    interactive: boolean;
+    permissions?: PermissionLease;
+    signal: AbortSignal;
+    stamp: string;
+    isCurrent: () => boolean;
+    confirm: (view: ApprovalView) => Promise<boolean>;
+};
+export type OperationResult = {
+    status: string;
+    data?: unknown;
+    problems?: ValidationProblem[];
+    message?: string;
+    candidateUrl?: string;
+};

package/dist/src/service-types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/service.d.ts

@@ -0,0 +1,4 @@
+import type { Operation, IssueArgs, LabelsArgs, FormArgs, OperationContext, OperationResult, ApprovalView } from './service-types.js';
+export declare function authorize(view: ApprovalView, ctx: OperationContext, repo: string, permissionOperation?: string, projectId?: string): Promise<boolean>;
+export declare function recheckAuthority(ctx: OperationContext, machine: boolean): Promise<void>;
+export declare function runOperation(operation: Operation, args: IssueArgs | LabelsArgs | FormArgs, ctx: OperationContext): Promise<OperationResult>;

package/dist/src/service.js

@@ -0,0 +1,123 @@
+import { loadDraft, validateDraft } from './core/draft.js';
+import { loadTemplate } from './core/template.js';
+import { renderForm } from './core/forms.js';
+import { createIssuePreview } from './core/issue-labels.js';
+import { submitIssue } from './core/submit.js';
+import { validateLabelChange } from './core/labels-input.js';
+import { previewLabelChange } from './core/labels-approval.js';
+import { applyLabelChange } from './core/labels-apply.js';
+import { maskDecodedSecrets } from './core/secrets.js';
+import { fail, parseJson } from './core/data.js';
+import { validateArguments, templatePath, inputPath } from './paths.js';
+import { safeResult, rejected, errorResult } from './result.js';
+const operations = ['gh_issue_validate', 'gh_issue_preview', 'gh_issue_submit', 'gh_labels_validate', 'gh_labels_preview', 'gh_labels_apply', 'gh_issue_form'];
+function active(ctx) { return !ctx.signal.aborted && ctx.isCurrent(); }
+function requireActive(ctx) { if (!active(ctx))
+    fail('STALE_OPERATION', '', 'Operation was cancelled or its session changed.'); }
+async function confirm(view, ctx) {
+    if (!active(ctx))
+        return false;
+    let listener = () => { };
+    const cancelled = new Promise(resolve => { listener = () => resolve(false); ctx.signal.addEventListener('abort', listener, { once: true }); });
+    try {
+        return await Promise.race([Promise.resolve().then(() => active(ctx) ? ctx.confirm(view) : false), cancelled]);
+    }
+    finally {
+        ctx.signal.removeEventListener('abort', listener);
+    }
+}
+export async function authorize(view, ctx, repo, permissionOperation = view.operation, projectId) {
+    requireActive(ctx);
+    if (ctx.permissions?.allows(permissionOperation, repo, projectId)) {
+        if (!await ctx.permissions.isCurrent())
+            fail('PERMISSION_CHANGED', '', 'Permission file changed.');
+        return true;
+    }
+    if (!ctx.interactive || !await confirm(view, ctx))
+        fail('APPROVAL_DENIED', '', 'Change was not approved.');
+    return false;
+}
+export async function recheckAuthority(ctx, machine) {
+    requireActive(ctx);
+    if (machine && (!ctx.permissions || !await ctx.permissions.isCurrent()))
+        fail('PERMISSION_CHANGED', '', 'Permission file changed.');
+    requireActive(ctx);
+}
+async function issue(args, ctx, withPreview = true) {
+    const input = await loadDraft(inputPath(args.draftPath, ctx)), bundle = await loadTemplate(templatePath(args, ctx)), checked = validateDraft(input, bundle);
+    if (!checked.issue)
+        return { checked };
+    if (!withPreview)
+        return { checked };
+    const sensitive = maskDecodedSecrets(parseJson(input.bytes)).sensitive || maskDecodedSecrets({ template: bundle.template, policy: bundle.policy }).sensitive;
+    const preview = await createIssuePreview(checked.issue, { signal: ctx.signal, beforeStart: () => active(ctx) });
+    return { checked, preview: { ...preview, sensitive: preview.sensitive || sensitive } };
+}
+export async function runOperation(operation, args, ctx) {
+    try {
+        if (!operations.includes(operation))
+            return rejected('ARGUMENT', 'Unknown operation.');
+        validateArguments(operation, args);
+        requireActive(ctx);
+        const write = operation === 'gh_issue_submit' || operation === 'gh_labels_apply';
+        if (write && !ctx.interactive && !ctx.permissions)
+            return rejected('APPROVAL_UI_REQUIRED', 'External changes require a local human confirmation screen.');
+        let machineAuthority = false;
+        const options = { signal: ctx.signal, beforeStart: () => active(ctx), beforeStartAsync: async () => !machineAuthority || !!ctx.permissions && await ctx.permissions.isCurrent() };
+        if (operation === 'gh_issue_form') {
+            const bundle = await loadTemplate(templatePath(args, ctx));
+            requireActive(ctx);
+            const masked = maskDecodedSecrets({ template: bundle.template, policy: bundle.policy });
+            return safeResult({ status: 'generated', data: { yaml: renderForm({ ...bundle, ...masked.value }) } });
+        }
+        if (operation.startsWith('gh_labels_')) {
+            const path = inputPath(args.changePath, ctx), input = await loadDraft(path);
+            validateLabelChange(input);
+            if (operation === 'gh_labels_validate')
+                return safeResult({ status: 'validated' });
+            const preview = await previewLabelChange(input, options);
+            requireActive(ctx);
+            const sensitive = preview.sensitive || maskDecodedSecrets(parseJson(input.bytes)).sensitive;
+            const displayed = { ...preview, sensitive };
+            if (operation === 'gh_labels_preview')
+                return safeResult({ status: 'preview', data: displayed });
+            if (sensitive)
+                return rejected('SENSITIVE', 'Remove secret candidates before applying.');
+            const change = validateLabelChange(input), permissionOperation = change.operation === 'label-delete' ? 'forbidden-delete' : change.operation === 'issue-labels' ? 'gh_issue_labels' : change.operation === 'label-create' ? 'gh_label_create' : 'gh_label_edit';
+            const machine = await authorize({ operation, text: JSON.stringify(maskDecodedSecrets(displayed).value, null, 2), digest: preview.digest }, ctx, change.repo, permissionOperation);
+            machineAuthority = machine;
+            requireActive(ctx);
+            const latest = await loadDraft(path), next = await previewLabelChange(latest, options);
+            requireActive(ctx);
+            if (next.digest !== preview.digest || next.sensitive || maskDecodedSecrets(parseJson(latest.bytes)).sensitive)
+                return rejected('APPROVAL_MISMATCH', 'Input or GitHub state changed; preview and approve again.');
+            await recheckAuthority(ctx, machine);
+            const result = await applyLabelChange(latest, preview.digest, options);
+            return safeResult({ ...result });
+        }
+        const captured = await issue(args, ctx, operation !== 'gh_issue_validate');
+        requireActive(ctx);
+        if (!captured.checked.issue)
+            return safeResult({ status: 'rejected', problems: captured.checked.problems });
+        if (operation === 'gh_issue_validate')
+            return safeResult({ status: 'validated' });
+        const preview = captured.preview;
+        if (operation === 'gh_issue_preview')
+            return safeResult({ status: 'preview', data: preview });
+        if (preview.sensitive)
+            return rejected('SENSITIVE', 'Remove secret candidates before submitting.');
+        const machine = await authorize({ operation, text: JSON.stringify(maskDecodedSecrets(preview).value, null, 2), digest: preview.digest }, ctx, preview.repo);
+        machineAuthority = machine;
+        requireActive(ctx);
+        const latest = await issue(args, ctx);
+        requireActive(ctx);
+        if (!latest.checked.issue || latest.preview.digest !== preview.digest || latest.preview.sensitive)
+            return rejected('APPROVAL_MISMATCH', 'Input or GitHub state changed; preview and approve again.');
+        await recheckAuthority(ctx, machine);
+        const result = await submitIssue(latest.checked.issue, preview.digest, options);
+        return safeResult(result.status === 'created' ? { status: 'created', data: { url: result.url } } : { ...result });
+    }
+    catch (error) {
+        return errorResult(error);
+    }
+}

package/examples/labels-create.json

@@ -0,0 +1,8 @@
+{
+  "version": 1,
+  "repo": "example/demo",
+  "operation": "label-create",
+  "name": "bug",
+  "color": "d73a4a",
+  "description": "不具合"
+}

package/examples/labels-delete.json

@@ -0,0 +1,6 @@
+{
+  "version": 1,
+  "repo": "example/demo",
+  "operation": "label-delete",
+  "name": "obsolete"
+}

package/examples/labels-edit.json

@@ -0,0 +1,9 @@
+{
+  "version": 1,
+  "repo": "example/demo",
+  "operation": "label-edit",
+  "name": "bug",
+  "newName": "不具合",
+  "color": "d73a4a",
+  "description": "確認済みの不具合"
+}

package/examples/labels-issue.json

@@ -0,0 +1,12 @@
+{
+  "version": 1,
+  "repo": "example/demo",
+  "operation": "issue-labels",
+  "issue": 123,
+  "add": [
+    "bug"
+  ],
+  "remove": [
+    "needs-triage"
+  ]
+}

package/examples/parent.json

@@ -0,0 +1,37 @@
+{
+  "version": 1,
+  "template": "parent",
+  "repo": "example/demo",
+  "title": "検索機能の仕様",
+  "fields": {
+    "purpose": "商品を検索できるようにする",
+    "specification": "入力語に一致する商品を一覧表示する",
+    "basicDesign": "既存の検索APIを利用。新しい基本設計は不要。",
+    "outOfScope": [
+      "全文検索エンジンの導入"
+    ],
+    "tasks": [
+      "子タスクを作成後、リンクを記録する"
+    ],
+    "completionCriteria": [
+      "仕様に沿った結果が表示され、独立検証が合格する"
+    ]
+  },
+  "agents": {
+    "coding-manager": {
+      "model": "openai-codex/gpt-6.1-sol",
+      "thinking": "medium",
+      "reason": "基本構成"
+    },
+    "coder": {
+      "model": "openai-codex/gpt-6-luna",
+      "thinking": "xhigh",
+      "reason": "基本構成"
+    },
+    "tester": {
+      "model": "openai-codex/gpt-6-luna",
+      "thinking": "xhigh",
+      "reason": "独立検証"
+    }
+  }
+}

package/examples/task.json

@@ -0,0 +1,51 @@
+{
+  "version": 1,
+  "template": "task",
+  "repo": "example/demo",
+  "title": "検索画面を実装する",
+  "parentIssue": 10,
+  "fields": {
+    "purpose": "商品検索画面を追加する",
+    "scope": [
+      "検索入力と結果一覧"
+    ],
+    "outOfScope": [
+      "検索APIの変更"
+    ],
+    "references": [
+      "親Issue #10の承認済み仕様"
+    ],
+    "dependencies": [
+      "なし：既存APIを利用"
+    ],
+    "executionOrder": "入力部と一覧部は別領域で並列作業可能。統合後に検証する。",
+    "acceptanceCriteria": [
+      {
+        "id": "C1",
+        "requirement": "一致する商品を表示する",
+        "verification": "テスト環境で検索入力を行う",
+        "expectedResult": "一致する商品だけ表示される"
+      }
+    ],
+    "estimate": "初期見積もり30〜90分、難易度中。保証ではない。",
+    "risk": "境界条件で結果表示が崩れる可能性",
+    "cost": "未算定：実行時のモデル料金・消費量が未確定"
+  },
+  "agents": {
+    "coding-manager": {
+      "model": "openai-codex/gpt-6.1-sol",
+      "thinking": "medium",
+      "reason": "基本構成"
+    },
+    "coder": {
+      "model": "openai-codex/gpt-6-luna",
+      "thinking": "xhigh",
+      "reason": "基本構成"
+    },
+    "tester": {
+      "model": "openai-codex/gpt-6-luna",
+      "thinking": "xhigh",
+      "reason": "独立検証"
+    }
+  }
+}

package/extensions/approval-ui.ts

@@ -0,0 +1,41 @@
+import type {ExtensionContext} from '@earendil-works/pi-coding-agent';
+import {ScrollView,Text,Key,matchesKey,wrapTextWithAnsi,truncateToWidth,type Component} from '@earendil-works/pi-tui';
+import type {ApprovalView} from '../src/service-types.js';
+type Scope={signal:AbortSignal;isCurrent:()=>boolean};
+function plain(text:string){return text.replace(/[\x00-\x08\x0b-\x1f\x7f-\x9f\u202a-\u202e\u2066-\u2069]/g,c=>'\\u'+c.charCodeAt(0).toString(16).padStart(4,'0'));}
+export async function showApproval(view:ApprovalView,scope:Scope,ui:ExtensionContext['ui']):Promise<boolean>{
+ if(scope.signal.aborted||!scope.isCurrent())return false;
+ try{
+  return await ui.custom<boolean>((tui,theme,_keys,done)=>{
+   let selected=0,settled=false;const text=plain(view.text),scroll=new ScrollView(new Text(text,0,0),{scrollbar:'hidden',overscroll:'contain'});
+   let cachedWidth=0,cachedLines:string[]=[];
+   const finish=(value:boolean)=>{if(settled)return;settled=true;done(value&&scope.isCurrent()&&!scope.signal.aborted);};
+   const abort=()=>finish(false);scope.signal.addEventListener('abort',abort,{once:true});
+   if(scope.signal.aborted||!scope.isCurrent())queueMicrotask(abort);
+   const component:Component&{dispose:()=>void}={
+    render(width){
+     const rows=tui.terminal.rows;if(width<16||rows<9||!scope.isCurrent()){queueMicrotask(abort);return [truncateToWidth('Approval unavailable. Cancelled.',width)];}
+     const viewport=Math.max(1,rows-7);if(cachedWidth!==width){cachedLines=wrapTextWithAnsi(text,Math.max(1,width));cachedWidth=width;}const lines=cachedLines;
+     scroll.updateLayout(lines.length,viewport,()=>tui.requestRender());
+     const top=scroll.scrollTop,visible=lines.slice(top,top+viewport);
+     return [theme.fg('accent',truncateToWidth('pi-gh review: '+view.operation,width)),truncateToWidth('Target and content below. No changes yet.',width),'',...visible,'',truncateToWidth((selected===0?'[Cancel]  Approve':'Cancel  [Approve]')+'   '+(top+1)+'/'+lines.length,width),truncateToWidth('Up/Down/PgUp/PgDn scroll; Left/Right choose; Enter; Esc cancel',width)];
+    },
+    handleInput(data){
+     if(settled)return;if(!scope.isCurrent()||scope.signal.aborted)return finish(false);
+     if(matchesKey(data,Key.escape)||matchesKey(data,Key.ctrl('c')))return finish(false);
+     if(matchesKey(data,Key.left)||matchesKey(data,Key.right)||matchesKey(data,Key.tab))selected=selected===0?1:0;
+     else if(matchesKey(data,Key.enter))return finish(selected===1);
+     else if(matchesKey(data,Key.up))scroll.scrollBy(-1);
+     else if(matchesKey(data,Key.down))scroll.scrollBy(1);
+     else if(matchesKey(data,Key.pageUp))scroll.scrollBy(-Math.max(1,tui.terminal.rows-7));
+     else if(matchesKey(data,Key.pageDown))scroll.scrollBy(Math.max(1,tui.terminal.rows-7));
+     else if(matchesKey(data,Key.home))scroll.scrollToStart();
+     else if(matchesKey(data,Key.end))scroll.scrollToEnd();
+     tui.requestRender();
+    },
+    invalidate(){cachedWidth=0;scroll.invalidate();},
+    dispose(){scope.signal.removeEventListener('abort',abort);settled=true;}
+   };return component;
+  });
+ }catch{return false;}
+}

package/extensions/index.ts

@@ -0,0 +1,12 @@
+import type {ExtensionAPI} from '@earendil-works/pi-coding-agent';
+import {fileURLToPath} from 'node:url';
+import {RuntimeScope} from './runtime-scope.ts';
+import {registerTools} from './tools.ts';
+export default function(pi:ExtensionAPI){
+ const scope=new RuntimeScope();registerTools(pi,scope,fileURLToPath(new URL('../',import.meta.url)));
+ pi.on('session_start',()=>scope.invalidate());
+ pi.on('session_before_switch',()=>scope.invalidate());
+ pi.on('session_before_fork',()=>scope.invalidate());
+ pi.on('session_before_tree',()=>scope.invalidate());
+ pi.on('session_shutdown',()=>scope.invalidate());
+}

package/extensions/runtime-scope.ts

@@ -0,0 +1,15 @@
+export class RuntimeScope {
+ private generation=0;private leases=new Set<AbortController>();private tail:Promise<unknown>=Promise.resolve();
+ get stamp(){return String(this.generation);}
+ isCurrent(stamp:string){return stamp===this.stamp;}
+ acquire(caller?:AbortSignal){
+  const controller=new AbortController(),stamp=this.stamp;this.leases.add(controller);
+  const abort=()=>controller.abort();caller?.addEventListener('abort',abort,{once:true});if(caller?.aborted)abort();
+  let disposed=false;return {stamp,signal:controller.signal,dispose:()=>{if(disposed)return;disposed=true;caller?.removeEventListener('abort',abort);this.leases.delete(controller);}};
+ }
+ invalidate(){this.generation++;for(const controller of this.leases)controller.abort();this.leases.clear();}
+ runExclusive<T>(fn:()=>Promise<T>):Promise<T>{
+  const stamp=this.stamp;const result=this.tail.then(()=>{if(!this.isCurrent(stamp))throw new Error('Session changed; queued operation expired.');return fn();});
+  this.tail=result.then(()=>undefined,()=>undefined);return result;
+ }
+}

package/extensions/tools.ts

@@ -0,0 +1,53 @@
+import {Type} from '@earendil-works/pi-ai';
+import type {ExtensionAPI,ExtensionToolContext} from '@earendil-works/pi-coding-agent';
+import {runOperation} from '../dist/src/service.js';
+import {safeResult,errorResult} from '../dist/src/result.js';
+import {loadPermissions,permissionPath} from '../dist/src/permissions.js';
+import {runGithubOperation} from '../dist/src/operations.js';
+import {githubReads,githubWrites} from '../dist/src/operation-input.js';
+import type {GithubOperation,GithubArgs} from '../src/operation-input.js';
+import type {Operation,IssueArgs,LabelsArgs,FormArgs,OperationResult} from '../src/service-types.js';
+import {showApproval} from './approval-ui.ts';
+import {RuntimeScope} from './runtime-scope.ts';
+const template={template:Type.Optional(Type.Union([Type.Literal('parent'),Type.Literal('task')])),templatePath:Type.Optional(Type.String({minLength:1}))};
+const issue=Type.Object({draftPath:Type.String({minLength:1}),...template},{additionalProperties:false});
+const labels=Type.Object({changePath:Type.String({minLength:1})},{additionalProperties:false});
+const form=Type.Object(template,{additionalProperties:false});
+const output=Type.Object({status:Type.String(),data:Type.Optional(Type.Unknown()),problems:Type.Optional(Type.Array(Type.Object({code:Type.String(),path:Type.String(),message:Type.String()}))),message:Type.Optional(Type.String()),candidateUrl:Type.Optional(Type.String())},{additionalProperties:false});
+const operations:Array<Operation|GithubOperation>=['gh_issue_validate','gh_issue_preview','gh_issue_submit','gh_labels_validate','gh_labels_preview','gh_labels_apply','gh_issue_form',...githubReads,...githubWrites];
+const repo=Type.String({minLength:3});
+const issueRead=Type.Object({repo,issue:Type.Integer({minimum:1})},{additionalProperties:false});
+const issueList=Type.Object({repo,state:Type.Optional(Type.Union([Type.Literal('open'),Type.Literal('closed'),Type.Literal('all')]))},{additionalProperties:false});
+const projectRead=Type.Object({projectId:Type.String({pattern:'^PVT_[A-Za-z0-9_-]+$'})},{additionalProperties:false});
+function identity(ctx:ExtensionToolContext){return ctx.sessionManager.getSessionId()+':'+ctx.sessionManager.getLeafId();}
+function render(result:OperationResult){
+ const safe=safeResult(result),full=JSON.stringify(safe),limit=32768;
+ return {content:[{type:'text' as const,text:full.length<=limit?full:full.slice(0,limit)+'\n[truncated; complete masked data in structuredContent]'}],details:safe,structuredContent:safe as never,isError:['rejected','not-started','unknown'].includes(safe.status)};
+}
+export function registerTools(pi:ExtensionAPI,scope:RuntimeScope,packageRoot:string){
+ pi.registerTool({name:'gh_capabilities',label:'GitHub capabilities',description:'Return pi-gh tool contract version and supported operations. No remote access.',parameters:Type.Object({},{additionalProperties:false}),outputSchema:output,annotations:{readOnlyHint:true,destructiveHint:false,idempotentHint:true,openWorldHint:false},async execute(){return render({status:'read',data:{contractVersion:1,operations:[...operations,'gh_capabilities']}});}});
+ for(const name of operations){
+  const write=name==='gh_issue_submit'||name==='gh_labels_apply'||(githubWrites as readonly string[]).includes(name);
+  pi.registerTool({
+   name,label:name,description:write?'Preview and apply one GitHub change after local human approval or an exact owner-configured permission grant. Never auto-retries unknown outcomes.':'Validate or preview a GitHub workflow. Preview may read remote metadata; never changes GitHub.',
+   parameters:(githubWrites as readonly string[]).includes(name)?labels:(githubReads as readonly string[]).includes(name)?(name==='gh_issue_list'?issueList:name.startsWith('gh_project_')?projectRead:issueRead):name.startsWith('gh_labels_')?labels:name==='gh_issue_form'?form:issue,outputSchema:output,
+   exposure:'direct',executionMode:write?'sequential':'parallel',
+   annotations:{readOnlyHint:!write,destructiveHint:write,idempotentHint:!write,openWorldHint:name!=='gh_issue_validate'&&name!=='gh_labels_validate'&&name!=='gh_issue_form'},
+   async execute(_id,args,signal,_update,ctx){
+    const captured=identity(ctx),lease=scope.acquire(signal),isCurrent=()=>scope.isCurrent(lease.stamp)&&identity(ctx)===captured;
+    const work=async()=>{
+     const child=!!process.env.PI_SUBAGENT_CHILD,headless=ctx.mode!=='tui'||!ctx.hasUI;
+     const permissions=write?await loadPermissions(permissionPath(),{child,headless}):undefined;
+     const context={
+      cwd:ctx.cwd,packageRoot,interactive:!headless&&!child,permissions,signal:lease.signal,stamp:lease.stamp,isCurrent,
+      confirm:(view:import('../src/service-types.js').ApprovalView)=>showApproval(view,{signal:lease.signal,isCurrent},ctx.ui)
+     };
+     return (githubReads as readonly string[]).includes(name)||(githubWrites as readonly string[]).includes(name)?runGithubOperation(name as GithubOperation,args as GithubArgs,context):runOperation(name as Operation,args as IssueArgs|LabelsArgs|FormArgs,context);
+    };
+    try{return render(write?await scope.runExclusive(work):await work());}
+    catch(error){return render(errorResult(error));}
+    finally{lease.dispose();}
+   }
+  });
+ }
+}

package/package.json

@@ -1,6 +1,53 @@
 {
   "name": "@papillon6814/pi-gh",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "Prepare and approve GitHub issue workflows inside Pi",
+  "type": "module",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "keywords": [
+    "pi-package"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/KendrickMalar/pi-gh.git"
+  },
+  "pi": {
+    "extensions": [
+      "extensions/index.ts"
+    ]
+  },
+  "files": [
+    "extensions/*.ts",
+    "dist/src",
+    "templates",
+    "examples",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.core.json",
+    "build:test": "tsc -p tsconfig.test.json",
+    "typecheck": "npm run build && tsc --noEmit -p tsconfig.test.json && tsc --noEmit -p tsconfig.extension.json",
+    "test:extension": "npm run build && node --test test/*.test.mjs",
+    "test:core": "npm run build && npm run build:test && node --test dist/test/core/*.test.js",
+    "test:service": "npm run build && npm run build:test && node --test dist/test/service*.test.js",
+    "test": "npm run build && npm run build:test && node --test dist/test/core/*.test.js dist/test/service*.test.js dist/test/package.test.js test/*.test.mjs"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*"
+  },
+  "dependencies": {
+    "yaml": "^2.8.1"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-coding-agent": "1.0.4",
+    "@types/node": "^22.15.30",
+    "jiti": "2.6.1",
+    "typescript": "^5.9.2"
+  }
+}

package/templates/parent.yml

@@ -0,0 +1,47 @@
+version: 1
+id: parent
+name: Parent specification
+description: 親Issue：仕様・基本設計とタスク管理
+kind: parent
+modelPolicy: policies/models.yml
+agents:
+  - coding-manager
+  - coder
+  - tester
+fields:
+  - id: purpose
+    label: 目的
+    type: text
+    required: true
+    description: 内容を記載。不要・未算定なら理由を記載
+    maxLength: 20000
+  - id: specification
+    label: 仕様
+    type: text
+    required: true
+    description: 内容を記載。不要・未算定なら理由を記載
+    maxLength: 20000
+  - id: basicDesign
+    label: 基本設計
+    type: text
+    required: true
+    description: 内容を記載。不要・未算定なら理由を記載
+    maxLength: 20000
+  - id: outOfScope
+    label: 対象外
+    type: string-list
+    required: true
+    description: 文字列の配列。対象がなければ理由付きで「なし」を記載
+    minItems: 1
+  - id: tasks
+    label: タスク一覧
+    type: string-list
+    required: true
+    description: 文字列の配列。対象がなければ理由付きで「なし」を記載
+    minItems: 1
+  - id: completionCriteria
+    label: 全体の完了条件
+    type: string-list
+    required: true
+    description: 文字列の配列。対象がなければ理由付きで「なし」を記載
+    minItems: 1

package/templates/policies/models.yml

@@ -0,0 +1,20 @@
+version: 1
+agents:
+  coding-manager:
+    - model: openai-codex/gpt-6.1-sol
+      thinking: medium
+      tier: basic
+  coder:
+    - model: openai-codex/gpt-6-luna
+      thinking: xhigh
+      tier: basic
+    - model: openai-codex/gpt-6.1-sol
+      thinking: medium
+      tier: upper
+  tester:
+    - model: openai-codex/gpt-6-luna
+      thinking: xhigh
+      tier: basic
+    - model: openai-codex/gpt-6.1-sol
+      thinking: medium
+      tier: upper

package/templates/task.yml

@@ -0,0 +1,71 @@
+version: 1
+id: task
+name: Implementation task
+description: タスクIssue：承認済み仕様に基づく実装と検証
+kind: task
+modelPolicy: policies/models.yml
+agents:
+  - coding-manager
+  - coder
+  - tester
+fields:
+  - id: purpose
+    label: 目的
+    type: text
+    required: true
+    description: 内容を記載。不要・未算定なら理由を記載
+    maxLength: 20000
+  - id: scope
+    label: 実装範囲
+    type: string-list
+    required: true
+    description: 文字列の配列。対象がなければ理由付きで「なし」を記載
+    minItems: 1
+  - id: outOfScope
+    label: 対象外
+    type: string-list
+    required: true
+    description: 文字列の配列。対象がなければ理由付きで「なし」を記載
+    minItems: 1
+  - id: references
+    label: 関連資料
+    type: string-list
+    required: true
+    description: 文字列の配列。対象がなければ理由付きで「なし」を記載
+    minItems: 1
+  - id: dependencies
+    label: 依存Issue
+    type: string-list
+    required: true
+    description: 文字列の配列。対象がなければ理由付きで「なし」を記載
+    minItems: 1
+  - id: executionOrder
+    label: 着手順序・並列範囲
+    type: text
+    required: true
+    description: 内容を記載。不要・未算定なら理由を記載
+    maxLength: 20000
+  - id: acceptanceCriteria
+    label: 受け入れ要件
+    type: criteria
+    required: true
+    description: id・requirement・verification・expectedResultを持つ配列
+    minItems: 1
+  - id: estimate
+    label: 工数・難易度
+    type: text
+    required: true
+    description: 内容を記載。不要・未算定なら理由を記載
+    maxLength: 20000
+  - id: risk
+    label: リスク
+    type: text
+    required: true
+    description: 内容を記載。不要・未算定なら理由を記載
+    maxLength: 20000
+  - id: cost
+    label: 費用と算定前提
+    type: text
+    required: true
+    description: 内容を記載。不要・未算定なら理由を記載
+    maxLength: 20000